schema-markup
When the user wants to implement, audit, or validate structured data (schema markup) on their website. Use when the user mentions 'structured data,' 'schema.org,' 'JSON-LD,' 'rich results,' 'rich snippets,' 'schema markup,' 'FAQ schema,' 'Product schema,' 'HowTo schema,' or 'structured data errors in Search Console.' Also use when someone asks why their content isn't showing rich results or wants to improve AI search visibility. NOT for general SEO audits (use seo-audit) or technical SEO crawl issues (use site-architecture).
Profile →npx skills add alirezarezvani/claude-skills --skill schema-markup --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Schema Markup Implementation You are an expert in structured data and schema.org markup. Your goal is to help implement, audit, and validate JSON-LD schema that earns rich results in Google, improves click-through rates, and makes content legible to AI search systems. ## Before Starting **Check for context first:** If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for what's missing. Gather this context: ### 1. Current State - Do they have any existing schema markup? (Check source, GSC Coverage report, or run the validator script) - Any rich results currently showing in Google? - Any structured data errors in Search Console? ### 2. Site Details - CMS platform (WordPress, Webflow, custom, etc.) - Page types that need markup (homepage, articles, products, FAQ, local business) - Can they edit `<head>` tags, or do they need a plugin/GTM? ### 3. Goals - Rich results target (FAQ dropdowns, star ratings, breadcrumbs, HowTo steps, etc.) - AI search visibility (getting cited in AI Overviews, Perplexity, etc.) - Fix existing errors vs implement net new --- ## How This Skill Works ### Mode 1: Audit Existing Markup When they have
- Before Starting
- 1. Current State
- 2. Site Details
- 3. Goals
- How This Skill Works
- Mode 1: Audit Existing Markup
- Mode 2: Implement New Schema
- Mode 3: Validate & Fix
- Schema Type Selection
- Implementation Patterns
- JSON-LD vs Microdata vs RDFa
- Placement
- Per-Page vs Site-Wide
- Reference patterns
What does the schema-markup skill do?
When the user wants to implement, audit, or validate structured data (schema markup) on their website. Use when the user mentions 'structured data,' 'schema.org,' 'JSON-LD,' 'rich results,' 'rich snippets,' 'schema markup,' 'FAQ schema,' 'Product schema,' 'HowTo schema,' or 'structured data errors in Search Console.' Also use when someone asks why their content isn't showing rich results or wants to improve AI search visibility. NOT for general SEO audits (use seo-audit) or technical SEO crawl issues (use site-architecture).
How do I install it?
Run `npx skills add alirezarezvani/claude-skills --skill schema-markup --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From alirezarezvani/claude-skills, a repository with 23,791 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.