Schema Markup Claude Skill
The Schema Markup Claude skill helps Claude choose and write Schema.org structured data in JSON-LD for marketers and developers chasing rich results and AI search visibility. It is free and open source under the MIT license, and it comes from kostja94's marketing-skills library on GitHub, in the on-page SEO group.
npx skills add kostja94/marketing-skills --skill schema-markupgit clone https://github.com/kostja94/marketing-skills.git && cp -r marketing-skills/skills/seo/on-page/schema ~/.claude/skills/schema-markupWhat the Schema Markup skill does
Schema work often goes wrong at the first step: picking a type because it exists, not because search engines use it. This skill starts by separating Schema.org, which has hundreds of types, from the smaller set Google and Bing actually turn into rich results. It tells Claude to check the current support list before promising stars or snippets.
It maps website and product types to the schema that fits. A recipe app gets Recipe, a job board gets JobPosting, a software page gets SoftwareApplication and a store gets Product. It also covers where Organization and WebSite belong, how to link entities with stable IDs, and how schema relates to SERP features.
The guidance is practical about what has changed. HowTo rich results are deprecated and FAQ eligibility is limited, so Claude is steered away from outdated advice. It also lists common errors, such as markup that does not match visible content or the wrong type for a page.
- Recommends core or specialist Schema.org types based on the site and page type
- Explains which types Google and Bing support for rich results and which they do not
- Maps site types such as recipe, job board, SaaS or store to the best-fit schema
- Places Organization and WebSite markup correctly and links entities using stable IDs
- Writes JSON-LD with required properties, ISO dates and matching visible content
- Covers Article, BreadcrumbList and multilingual markup with inLanguage
- Lists common errors like type mismatches, syntax mistakes and over-markup
- Provides validation steps with Google's Rich Results Test and the Schema Markup Validator
How it works
Analyze the page
Claude identifies the page type, the entities on it and the goal, such as rich snippets, AI search visibility or a knowledge panel.
Choose schema types
It picks core types for most pages and specialist types only when the content truly matches, checked against what search engines support.
Write the JSON-LD
Claude drafts the structured data with required properties first, stable IDs, correct dates, and only facts visible on the page.
Validate the markup
You run it through the Rich Results Test and Schema Markup Validator, and Claude fixes errors like missing properties or broken syntax.
Deploy and monitor
After publishing, Claude points you to the Search Console enhancement reports to confirm the markup is read and eligible.
Example prompts
Once the Schema Markup skill is installed, ask Claude in plain language. These prompts trigger it:
- Which schema types should my SaaS pricing page and blog posts use
- Write JSON-LD Organization and WebSite schema for my homepage
- Add Product schema with offers and ratings to this e-commerce page
- Check my existing schema for errors and mismatches with the visible content
- What structured data helps my pages get cited in AI answers
What you get
- A schema type recommendation, split into core and specialist types
- A page-by-page mapping of which pages get which schema
- Ready-to-paste JSON-LD with the required properties filled in
- Validation steps and a list of errors to fix
Who it is for
- Marketers adding structured data to a site without writing it by hand
- Developers who need a clear map from page type to Schema.org type
- SEOs fixing schema errors or removing outdated markup
- Teams who want structured data to support both Google rich results and AI search
How to install the Schema Markup skill
What you need: Nothing beyond Claude. Works with Claude Code and Claude.ai. A project context file is read if present. Validation uses free Google and Schema.org tools.
- Skills CLI
npx skills add kostja94/marketing-skills --skill schema-markup - Manual
git clone https://github.com/kostja94/marketing-skills.git && cp -r marketing-skills/skills/seo/on-page/schema ~/.claude/skills/schema-markup
After installing, restart Claude Code or start a new session. Claude loads the Schema Markup skill automatically when your request matches it, or you can ask for it by name.
Tips for better results
- Tell Claude the exact page type and paste the visible content. Schema must describe what users can see.
- Validate in a rendered view. Plugins often inject JSON-LD with JavaScript, which plain fetches miss.
- Do not add markup types just because they exist. Check that Google supports them for rich results first.
Limitations
- It recommends and writes markup but cannot confirm whether Google will actually show a rich result.
- Eligibility rules change, so verify current support in Google's documentation before relying on a type.
Schema Markup Claude skill FAQ
Yes. It is MIT licensed and published openly in kostja94's marketing-skills repository on GitHub, so you can use, copy and modify it at no cost.
Run npx skills add kostja94/marketing-skills --skill schema-markup from your project to install only this skill. The repository README recommends installing a small focused set of skills rather than the whole library.
Skills that are just a SKILL.md plus reference files can be zipped and uploaded in Claude.ai under Settings, Capabilities, Skills on paid plans. This one is mostly instructions, so that route can work, but it gets more done where Claude can fetch live pages. Claude Code is the safest choice.
Schema is not described as a direct ranking factor in this skill. Its value is eligibility for rich results and clearer machine-readable meaning, which AI search tools can also use. Mark up only what users see, and validate the result.
The skill suggests Organization and WebSite on the homepage, Article for blog posts, BreadcrumbList for navigation and SoftwareApplication for product pages. Add specialist types only when the page content truly matches them.