Agent skill

Schema.org Markup Detector and Generator

by AgriciDaniel in AgriciDaniel/claude-seo

Detects, validates and generates Schema.org JSON-LD for a page, flagging deprecated or retired rich-result types using an actively updated status list.

MITAuto-check passedMarketing & SEO

Install Schema.org Markup Detector and Generator

skills CLI
$ npx skills add AgriciDaniel/claude-seo --skill seo-schema -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-seo seo-schema --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-schema .claude/skills/seo-schema && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-schema
GitHub stars
19k
Token cost
~1.8k tokens
SKILL.md length
649 words
Files
3 (incl. references)
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Detects, validates and generates Schema.org JSON-LD for a page, flagging deprecated or retired rich-result types using an actively updated status list.

  • Works in 4 steps: Extract JSON-LD with… → Check for Microdata (itemscope, itemprop) → Check for RDFa (typeof, property) → …
  • Checking whether a page's existing structured data is valid
  • SKILL.md covers Detection, Validation, Schema Type Status (as of June… and Generation, plus 3 more sections
  • Reaches schema.org

What it does

This skill extracts JSON-LD from a page's rendered HTML, flags any block missing @context or @type since Google cannot attach such a block to an entity, and checks for older Microdata and RDFa markup too, always recommending JSON-LD as the format to use going forward. Validation covers required properties per schema type, Google's supported rich-result types, and common errors such as invalid dates, relative URLs that should be absolute, and leftover placeholder text.

A dated schema type status list separates types that are active and safe to recommend, such as Organization, Product, Article and Event, from types with no rich-result benefit that can still be kept if useful, like FAQPage after Google retired its rich results for all sites, and from types that are fully deprecated and should never be recommended, such as HowTo and SpecialAnnouncement. A note on JavaScript-rendered structured data warns that dynamically generated Product markup can make Shopping crawls less frequent and reliable, so time-sensitive Product and Offer markup should ship in the initial server-rendered HTML.

Ready-to-use JSON-LD templates for the actively recommended types are provided in a separate templates file, and a references folder tracks types deprecated between 2024 and 2026.

When your agent uses it

  • Checking whether a page's existing structured data is valid
  • Generating new JSON-LD markup for a page or entity
  • Finding out whether a schema type still earns rich results in Google Search
  • Reviewing whether JavaScript-rendered product markup is safe to rely on

Example prompts

  • “Check this product page's JSON-LD for missing or invalid properties.”
  • “Generate Article and BreadcrumbList schema for this blog post.”
  • “Is FAQPage schema still worth keeping on our help pages?”
  • “Our Product markup is rendered client-side. Is that a problem for Shopping?”

Requirements

  • The bundled claude-seo CLI scripts

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Extract JSON-LD with "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py --url --json
  2. Check for Microdata (itemscope, itemprop)
  3. Check for RDFa (typeof, property)
  4. Always recommend JSON-LD as primary format (Google's stated preference)

What it can do on your machine

Read from SKILL.md and the folder at commit 4b99de2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • schema.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Schema.org Markup Detector and Generator loads about 1.8k tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 649 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-seo at commit 4b99de2, republished under its MIT licence (© AgriciDaniel). 649 words, ~1,767 tokens.

Download SKILL.mdSave it as .claude/skills/seo-schema/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
seo-schema
description
Detect, validate, or generate Schema.org JSON-LD for a supplied page or entity. Use only when structured data or rich-result markup is requested.
user-invocable
true
argument-hint
[url]
license
MIT
metadata.author
AgriciDaniel
metadata.version
2.4.2
metadata.category
seo

Schema Markup Analysis & Generation

Detection

  1. Extract JSON-LD with "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py --url <url> --json (or scan <script type="application/ld+json"> in the page source). Flag any block without @context or @type: Google cannot attach it to an entity (a rating in such a block does not reach the Product).
  2. Check for Microdata (itemscope, itemprop)
  3. Check for RDFa (typeof, property)
  4. Always recommend JSON-LD as primary format (Google's stated preference)

Validation

  • Check required properties per schema type
  • Validate against Google's supported rich result types
  • Test for common errors:
    • Missing @context
    • Invalid @type
    • Wrong data types
    • Placeholder text
    • Relative URLs (should be absolute)
    • Invalid date formats
  • Flag deprecated types (see below)

Schema Type Status (as of June 2026)

Read ../seo/references/schema-types.md for the full list. Key rules:

ACTIVE (recommend freely):

Organization, LocalBusiness, SoftwareApplication, WebApplication, Product (with Certification markup as of April 2025), ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting

VIDEO & SPECIALIZED (recommend freely):

BroadcastEvent, Clip, SeekToAction, SoftwareSourceCode

See schema/templates.json for ready-to-use JSON-LD templates for these types.

JSON-LD and JavaScript rendering: Google supports structured data generated with JavaScript, but its "Generate structured data with JavaScript" guide (last updated 2025-12-10) warns that dynamically generated Product markup can make Shopping crawls less frequent and less reliable for fast-changing price and availability. For time-sensitive markup (especially Product, Offer), include JSON-LD in the initial server-rendered HTML.

NO RICH RESULTS, KEEP IF USEFUL:
  • FAQPage: Google retired FAQ rich results for ALL sites on May 7, 2026 (supersedes the Aug 2023 gov/health restriction). No Google SERP rich-result benefit; flag existing FAQPage at Info (not Critical) rather than removal. For genuine user Q&A pages, use QAPage.
DEPRECATED (never recommend):
  • HowTo: Rich results removed September 2023
  • SpecialAnnouncement: Deprecated July 31, 2025
  • CourseInfo, EstimatedSalary, LearningVideo: Retired June 2025
  • ClaimReview: No Search rich result since June 2025. Google's Fact Check Explorer still uses the markup, so fact-checking publishers may keep it; never recommend it for SERP features
  • VehicleListing: Retired from rich results June 2025
  • Practice Problem: Deprecation notice 2025-11-05; tooling support removed starting January 2026; documentation removed 2026-01-06
  • Search Console / Rich Results Test / appearance-filter support for CourseInfo, ClaimReview, EstimatedSalary, LearningVideo, SpecialAnnouncement, VehicleListing was removed 2025-09-09 (Search Console API through December 2025).
Still supported (despite earlier phase-out notices):
  • Book Actions: NOT deprecated. The June 2025 phase-out banner was removed on 2025-11-05 because a Search feature still uses the markup.
Show full SKILL.md (251 more words)Show less
Supported for Dataset Search only:
  • Dataset: Not discontinued; consumed by Google Dataset Search, with no Google Search rich-result surface. Don't advise removal as if it were killed.
Still supported (do not flag):
  • QAPage (expanded comment-thread properties 2026-03-24), DiscussionForumPosting, Education Q&A (Quiz / eduQuestionType=Flashcard). For e-commerce, hasAdultConsideration (added 2026-05-20; value https://schema.org/SexualContentConsideration) is required for adult products. Product.category accepts Text, CategoryCode, or arrays mixing both.

Generation

When generating schema for a page:

  1. Identify page type from content analysis
  2. Select appropriate schema type(s)
  3. Generate valid JSON-LD with all required + recommended properties
  4. Include only truthful, verifiable data. Use placeholders clearly marked for user to fill
  5. Validate output before presenting
  6. For review markup, reject fake reviews and undisclosed incentivized reviews. An incentive must be clearly and prominently disclosed on the page.

Common Schema Templates

Organization
json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[Company Name]",
  "url": "[Website URL]",
  "logo": "[Logo URL]",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "[Phone]",
    "contactType": "customer service"
  },
  "sameAs": [
    "[Facebook URL]",
    "[LinkedIn URL]",
    "[Twitter URL]"
  ]
}
LocalBusiness
json
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "[Business Name]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[Street]",
    "addressLocality": "[City]",
    "addressRegion": "[State]",
    "postalCode": "[ZIP]",
    "addressCountry": "US"
  },
  "telephone": "[Phone]",
  "openingHours": "Mo-Fr 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "[Lat]",
    "longitude": "[Long]"
  }
}
Article/BlogPosting
json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "[Title]",
  "author": {
    "@type": "Person",
    "name": "[Author Name]"
  },
  "datePublished": "[YYYY-MM-DD]",
  "dateModified": "[YYYY-MM-DD]",
  "image": "[Image URL]",
  "publisher": {
    "@type": "Organization",
    "name": "[Publisher]",
    "logo": {
      "@type": "ImageObject",
      "url": "[Logo URL]"
    }
  }
}

Output

  • SCHEMA-REPORT.md: detection and validation results
  • generated-schema.json: ready-to-use JSON-LD snippets
Validation Results
SchemaTypeStatusIssues
......✅/⚠️/❌...
Recommendations
  • Missing schema opportunities
  • Validation fixes needed
  • Generated code for implementation

Error Handling

ScenarioAction
URL unreachableReport connection error with status code. Suggest verifying URL and checking if the page requires authentication.
No schema markup foundReport that no JSON-LD, Microdata, or RDFa was detected. Recommend appropriate schema types based on page content analysis.
Invalid JSON-LD syntaxParse and report specific syntax errors (missing brackets, trailing commas, unquoted keys). Provide corrected JSON-LD output.
Deprecated schema type detectedFlag the deprecated type with its retirement date. Recommend the current replacement type or advise removal if no replacement exists.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/seo-schema of AgriciDaniel/claude-seo.

  • SKILL.md
  • LICENSE.txt
  • references/deprecated-types-2024-2026.md

Open the folder on GitHubat commit 4b99de2

Compare with similar skills

Schema.org Markup Detector and Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Schema.org Markup Detector and Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Schema.org Markup Detector and Generator this skillAgriciDaniel/claude-seo19k—~1.8kAutomated safety check: PassMIT
Product Page SEOadobe/skills197—~2.8kAutomated safety check: PassApache-2.0
SEO Technicalrampstackco/claude-skills941—~1.8kAutomated safety check: PassMIT
Technical SEOindranilbanerjee/digital-marketing-pro8591 repos~5.9kAutomated safety check: NotesMIT
Meowhub Browserzhaojiaqi/MeowHub111—~1.6kAutomated safety check: PassGPL-3.0
Agent Readiness Auditindranilbanerjee/digital-marketing-pro8591 repos~3.9kAutomated safety check: PassMIT

Similar skills

  • Product Page SEO

    adobe/skills

    Optimize AEM Edge Delivery Services commerce product pages for search engine crawling and indexing.

    197 GitHub stars~2.8k tokensUpdated today
    Marketing & SEOAuto-check passed
  • SEO Technical

    rampstackco/claude-skills

    Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization.

    941 GitHub stars~1.8k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Technical SEO

    indranilbanerjee/digital-marketing-pro

    Deep technical SEO knowledge module covering Core Web Vitals, crawlability, indexation, site architecture, JavaScript SEO, redirects, structured data, hreflang, and migrations — producing audit…

    859 GitHub starsUsed in 1 repo~5.9k tokens
    Marketing & SEOAuto-check: notes
  • Meowhub Browser

    zhaojiaqi/MeowHub

    Browse the web using Browserless.io cloud browser service. An agent skill from zhaojiaqi/MeowHub.

    111 GitHub stars~1.6k tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed
  • Agent Readiness Audit

    indranilbanerjee/digital-marketing-pro

    Audit whether AI agents and AI crawlers can actually use a site — robots.txt rules per AI crawler token (OpenAI, Anthropic and Perplexity bots, Google-Extended, Applebot-Extended)…

    859 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed

More from AgriciDaniel/claude-seo

All 33 skills in this repo
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Auto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Auto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    19k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed

Works with

Categories

Questions about Schema.org Markup Detector and Generator

What does Schema.org Markup Detector and Generator do?

Detects, validates and generates Schema.org JSON-LD for a page, flagging deprecated or retired rich-result types using an actively updated status list. This skill extracts JSON-LD from a page's rendered HTML, flags any block missing @context or @type since Google cannot attach such a block to an entity, and checks for older Microdata and RDFa markup too, always recommending JSON-LD as the format to use going forward. Validation covers required properties per schema type, Google's supported rich-result types, and common errors such as invalid dates, relative URLs that should be absolute, and leftover placeholder text.

When should I use Schema.org Markup Detector and Generator?

Schema.org Markup Detector and Generator fits situations like: checking whether a page's existing structured data is valid; generating new JSON-LD markup for a page or entity; finding out whether a schema type still earns rich results in Google Search; reviewing whether JavaScript-rendered product markup is safe to rely on.

How do I install Schema.org Markup Detector and Generator in Claude Code?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-schema -a claude-code`. Or copy the skill folder (skills/seo-schema in AgriciDaniel/claude-seo) into .claude/skills/seo-schema in your project. Claude Code loads it when a task matches its description.

How do I install Schema.org Markup Detector and Generator in Codex?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-schema -a codex`. Or copy the skill folder (skills/seo-schema in AgriciDaniel/claude-seo) into .agents/skills/seo-schema in your project. Codex loads it when a task matches its description.

Can I use Schema.org Markup Detector and Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-seo --skill seo-schema -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-schema, .gemini/skills/seo-schema, .github/skills/seo-schema and .opencode/skills/seo-schema in your project.

What does Schema.org Markup Detector and Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Schema.org Markup Detector and Generator is instructions for the agent only. Our summary lists: The bundled claude-seo CLI scripts.

Does Schema.org Markup Detector and Generator access the network?

SKILL.md names 1 domain. In commands or code: schema.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Schema.org Markup Detector and Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Schema.org Markup Detector and Generator use?

Schema.org Markup Detector and Generator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Schema.org Markup Detector and Generator use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Schema.org Markup Detector and Generator?

Skills that share tags, products or a category with Schema.org Markup Detector and Generator: Product Page SEO (adobe/skills, 197 stars), SEO Technical (rampstackco/claude-skills, 941 stars), Technical SEO (indranilbanerjee/digital-marketing-pro, 859 stars) and Meowhub Browser (zhaojiaqi/MeowHub, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Schema.org Markup Detector and Generator?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,574 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 4, 2026.

Source: AgriciDaniel/claude-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.