Jake Labate, SEO Professional

Schema Markup Audit Claude Skill

By Jake Labate, SEO Professional Published | Updated Read Time 2 mins

This skill audits a website's structured data and produces an actionable SEO report. It extracts JSON-LD, Microdata, and RDFa from pages, validates the markup against schema.org and Google rich result requirements, and finds missing, invalid, or incomplete schema, then recommends concrete fixes.

View the skill files View on GitHub

Quick Take

Point the skill at a site URL, sitemap, or local HTML folder. It builds a structured data inventory, runs severity-ranked validation checks, and returns a prioritized report with copy-pasteable JSON-LD fixes.

What The Skill Checks

  • Invalid JSON-LD parse errors, missing required properties for declared types, and key page types with no schema at all, each reported with the exact page, schema type, and property.
  • Missing recommended properties for rich results, schema that describes content not actually on the page, conflicting or duplicate schema blocks, and deprecated types or properties.
  • Missing Organization and WebSite schema on the homepage, mixed JSON-LD and Microdata duplicates of the same entity, and missing optional enhancements like sameAs and BreadcrumbList.

How The Skill Is Packaged

The skill follows the standard Claude Agent Skill structure: a SKILL.md file with YAML frontmatter and workflow instructions, a references/ folder with the full audit check definitions and report template, and a scripts/ folder with Python scripts that extract structured data from pages and validate the resulting inventory. Copy the skill folder into your Claude skills directory and Claude invokes it automatically when a request matches its description.

Skill Files

Every file in the skill is embedded below directly from the Claude-SEO-Skills repository, so you can review exactly what the skill instructs Claude to do before installing it.

SKILL.md

The skill definition: frontmatter, inputs to collect, the six-step audit workflow, and the resources the skill relies on.

Audit Checks Reference (references/audit-checks.md)

Full definitions, severities, and rationale for every audit check, plus required and recommended properties per schema type.

Report Template (references/report-template.md)

The output structure the skill follows when writing the final audit report.

Schema Extractor Script (scripts/extract_schema.py)

Crawls a live site or local HTML folder within the configured page limits and extracts all JSON-LD, Microdata, and RDFa into a JSON inventory.

Schema Validator Script (scripts/validate_schema.py)

Runs the audit checks against the schema inventory JSON and outputs the structured audit report data.