Awaiting product image

Schema Markup Generator — Claude AI Skill for Rich Results & Structured Data

Generates, audits, and fixes JSON-LD schema markup for any page type and site vertical. Covers 15+ Google-supported schema types across SaaS, ecommerce, medical, legal, local business, blog, events, and more. Self-validates required properties before delivery. Includes 2026 deprecation updates, severity-tiered audit mode, and four specialist reference guides.

Get this skill
✦ New skills added weekly
Category:

Description

The problem with schema markup

Your schema passes the Rich Results Test. Your rich results never show up. Why?

Schema markup is easy to get almost right. A missing required property, an incorrect type, a relative URL where Google expects absolute — and you’re ineligible for rich results without a single error message to explain it. Claude out of the box generates schema that looks correct but skips validation against Google’s required property lists, chooses generic types over specific ones, and has no knowledge of which schema types are deprecated in 2026.

Missing required properties — schema generates without errors but is quietly ineligible because a required field is absent
Wrong or generic type chosen — Article when it should be BlogPosting, LocalBusiness when MedicalClinic is available, Product without Offer
Stale schema advice — generating FAQ schema that was deprecated in May 2026 and no longer produces rich results in Google Search

The fix

Schema Markup Generator gives Claude the expertise of a structured data specialist — generating Rich Results Test-ready JSON-LD for any page type, self-validating before delivery, and staying current with Google’s 2026 requirements

Four reference files — schema types, site-type mapping, Google guidelines, and a validation checklist — loaded on demand. Generate, audit, or fix schema for any site vertical: SaaS, ecommerce, local business, medical, legal, news, blog, events, and more.

×
Without Schema Markup Generator
VS
✓
With Schema Markup Generator

Generates JSON-LD that passes syntax validation but silently omits required properties — ineligible for rich results with no error to show for it

Self-validates every required property before delivering — checks against Google’s required property list for that exact schema type, not just JSON syntax

Chooses Article for every blog post — doesn’t know that BlogPosting, NewsArticle, TechArticle, and ScholarlyArticle each unlock different rich result eligibility

Reads the site-type mapping to select the most specific applicable type — MedicalClinic over LocalBusiness, BlogPosting over Article, SoftwareApplication for SaaS product pages

Still generating FAQ schema in 2026 — adds markup that was deprecated in May 2026 and no longer produces the accordion rich result in Google Search

Knows the 2026 deprecation status of FAQPage and HowTo — informs you that the markup is valid but won’t generate rich results, and suggests what to use instead

Audit mode says “looks fine” — no severity tiers, no distinction between an error that causes test failure and a warning that suppresses rich results

Audits flag every issue with three severity tiers — 🔴 Error (Rich Results Test failure), 🟡 Warning (suppresses rich results), 🟢 Suggestion (improves richness) — plus the corrected complete schema

Handles one schema type per request with no guidance on which additional schemas should accompany it on the same page

Generates multi-schema pages — knows that a product page should have Product + BreadcrumbList + Organization, and outputs them as separate JSON-LD blocks with implementation guidance

What you get

Everything inside the download

Schema Generator
JSON-LD generation for every Google-supported schema type — Article, BlogPosting, Product, LocalBusiness, Organization, SoftwareApplication, Event, Course, Recipe, Review, BreadcrumbList, and more. Always copy-paste ready and Rich Results Test-ready.
Schema Auditor
Paste any existing schema and get a severity-tiered audit: 🔴 errors that fail the Rich Results Test, 🟡 warnings that suppress rich results, 🟢 suggestions that improve richness — plus the corrected, complete JSON-LD block.
Schema Types Reference
Required and recommended properties for every Google-supported schema type — with correct data types, format requirements (ISO 8601, E.164, absolute URLs), and a complete valid example for each type.
Site-Type Mapping
Which schemas to use for which site vertical — SaaS, ecommerce, medical, legal, local business, blog, news, events, courses, recipes. Eliminates the guesswork of type selection and prevents generic-type mistakes.
Google Guidelines Reference
Deep-dive on Google’s structured data content policies and spam policies — what gets a manual action, what suppresses rich results, and what the rules say about reviews, ratings, and product data.
Validation Checklist
Property-by-property validation checklist for the most common schema types — critical errors that cause test failure, quality warnings that suppress results, and the exact fixes for each issue.

How it works

Three modes — generate, audit, fix

1
Generate — “Add schema markup to my product page”
Complete, Rich Results Test-ready JSON-LD in one shot

Tell Claude the page URL, page type, and site vertical. The skill identifies which schema types apply (using the site-type mapping), checks required properties for each type, generates the complete JSON-LD, self-validates the output against the critical errors checklist, then delivers the copy-paste-ready code with placement instructions and a link to test it in the Rich Results Test.

<script type="application/ld+json">
[
  {
    "@context": "https://schema.org",
    "@type": "Product",
    "name": "SEO Specialist — Claude AI Skill",
    "url": "https://theaiagentmarketplace.com/claude-skills/seo/seo-specialist/",
    "image": "https://theaiagentmarketplace.com/wp-content/uploads/seo-specialist.jpg",
    "description": "World-class SEO skill for Claude...",
    "offers": {
      "@type": "Offer",
      "price": "19.00",
      "priceCurrency": "USD",
      "availability": "https://schema.org/InStock"
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [...]
  }
]
</script>

✅ Validation: Required properties confirmed — name, offers (price + priceCurrency + availability)
✅ URLs: All absolute, HTTPS
✅ Price format: string of number — no currency symbol in price field
Place in <head> — test at: search.google.com/test/rich-results
2
Audit — “Why isn’t my rich result showing?”
Paste existing schema — get severity-tiered issues and the corrected markup

Paste your existing JSON-LD. The skill parses it, checks every property against Google’s required and recommended lists, flags issues with severity tiers, and delivers the corrected, complete schema ready to replace the old one.

SCHEMA AUDIT — LocalBusiness

🔴 Error: "image" is a relative URL (/images/logo.png) — must be absolute
   Fix: "image": "https://yourdomain.com/images/logo.png"

🔴 Error: "telephone" missing — required for LocalBusiness rich results
   Fix: add "telephone": "+1-555-123-4567"

🟡 Warning: "@type" is "LocalBusiness" — consider "MedicalClinic" for medical practices
   This unlocks the MedicalClinic rich result type in Google Search

🟢 Suggestion: add "openingHoursSpecification" to show hours in Knowledge Panel
   Example: {"@type":"OpeningHoursSpecification","dayOfWeek":["Monday"],"opens":"09:00","closes":"17:00"}

Corrected schema: [full corrected JSON-LD block below]
3
Multi-Schema — “What schema does my SaaS homepage need?”
Get every applicable schema type for any page or site vertical

Describe your page and site type. The skill reads the site-type mapping to identify every relevant schema, generates each one, and packages them as separate JSON-LD blocks with an explanation of what rich result each enables. For a SaaS homepage: Organization + WebSite (sitelinks search box) + SoftwareApplication. For a blog post: BlogPosting + BreadcrumbList. For an ecommerce product: Product + Offer + BreadcrumbList + optionally AggregateRating (if you have real reviews).

Made for

Who gets the most out of this skill

SEO Specialists & Consultants
Generate validated schema for client sites without manually cross-referencing schema.org docs. Audit existing client markup, find the hidden errors suppressing rich results, and deliver corrected JSON-LD in minutes rather than an hour of manual checking.
Developers Building SEO-Ready Sites
Get the exact JSON-LD blocks you need for any page type — copy-paste ready, with placement instructions and Rich Results Test validation guidance. No more back-and-forth with the SEO team on whether you chose the right schema type.
Content & Marketing Teams
Add schema markup to blog posts, news articles, and event pages without needing a developer or SEO specialist. The skill walks you through what information is needed, then generates markup you can paste directly into your CMS or hand to your developer.
Agencies Handling Multiple Verticals
Medical, legal, local business, ecommerce, SaaS — the site-type mapping covers every vertical your clients work in. One skill handles all of them correctly, without you needing to remember which schema types each vertical uses or which properties each type requires.
4
reference files
15+
schema types covered
3
severity tiers in audit
$19
all skills included

Getting started

Up and running in 3 steps

1
Download
Purchase your subscription and download the Schema Markup Generator — a .skill file with SKILL.md and four specialist reference guides.
2
Install in Claude
Drop the files into your Claude skills folder. Full instructions included. Works with Claude.ai Pro, Claude Code, and the API.
3
Generate or audit
Describe your page and ask Claude to add schema markup, paste existing schema for an audit, or ask “what schema does my [page type] need?” — the skill picks the right mode automatically.

Technical specs

File format.md (Markdown) — opens in any text editor
Compatible withClaude.ai Pro/Team, Claude Code, Claude API (all models)
Optimised forClaude Sonnet 4 and above — works on all recent Claude models
Reference filesIncludes schema-types.md, site-type-mapping.md, google-guidelines.md, and validation-checklist.md
External tools requiredNone — works from your page description or pasted schema. Rich Results Test is free at search.google.com/test/rich-results.
Schema formatJSON-LD only (Google’s recommended format) — no Microdata or RDFa
DeliveryInstant download — included in subscription
LicenseCommercial use included — use across unlimited client accounts
UpdatesLifetime updates included with subscription

FAQ

Common questions

Does it work for any CMS — WordPress, Webflow, Shopify?
Yes — the skill generates pure JSON-LD that you paste into any CMS. For WordPress, it tells you to use a plugin like RankMath, Yoast, or a Custom HTML block in Gutenberg. For Shopify, it goes in your theme’s <head>. For Webflow, it goes in the page’s Custom Code section. Platform-agnostic output.
Can I add schema for reviews without having many reviews yet?
The skill follows Google’s rules strictly: AggregateRating can only be added if you have real user reviews. It will not generate fake or placeholder ratings — those trigger manual actions from Google. Once you have real reviews (even one), it generates the correct AggregateRating block with the exact ratingValue and ratingCount from your actual data.
Is FAQPage schema still worth adding in 2026?
FAQPage schema was deprecated for rich results in May 2026 — the accordion no longer shows in Google Search. The markup is still valid JSON-LD and won’t cause errors, but it won’t produce a visual rich result. The skill will inform you of this when you ask about FAQ schema and can suggest alternatives (like improving your content for AI Overviews).
What’s the difference between an error and a warning in audit mode?
A 🔴 Error means the schema will fail the Rich Results Test — required property missing, invalid URL format, bad data type. A 🟡 Warning means the schema passes the test but Google may suppress the rich result — misleading data, generic type chosen over specific, unverified ratings. A 🟢 Suggestion is a recommended property that improves how rich the result looks — adding opening hours, price range, or social profiles.
What’s your purchase policy?
We stand behind every product. Our purchase policy covers delivery, licensing, and how we handle concerns. Learn more →

Your Claude. Structured data specialist.

Stop guessing why your rich results won’t show.
Start generating schema that actually passes.

15+ schema types. Severity-tiered audits. 2026 deprecation updates. Four specialist reference guides. Included in subscription.

Get this skill
Included in subscription · Instant download · Commercial use included

Browse more Claude skills

Related products

Claude AI SkillAll skills · One subscription
Get this skill