Marketer pack
Claude Skill
Structured Data Schema Writer
Implements accurate JSON-LD structured data so pages qualify for rich results — FAQ, product, review, breadcrumb.
What it does
Adds or fixes schema.org markup in JSON-LD so search engines understand the page and it qualifies for rich results — star ratings, FAQ accordions, breadcrumbs, product cards. Matches the schema type to the page's actual content, keeps it accurate to what's really on the page, and validates against Google's requirements.
When to use
- ✓You want rich results (star ratings, FAQ, breadcrumbs) in Google
- ✓Adding FAQ, product, review, or breadcrumb schema to pages
- ✓Fixing schema errors flagged in Search Console
When not to use
- ✗It's a broader SEO problem — start with an audit
- ✗You'd be marking up content that isn't actually on the page
Install
Download the .zip, then unzip into your Claude skills folder.
mkdir -p ~/.claude/skills
unzip ~/Downloads/structured-data-schema-writer.zip -d ~/.claude/skills/
# Restart Claude Code session.
# Skill is now available — Claude will use it when relevant.SKILL.md
SKILL.md
---
name: structured-data-schema-writer
description: Use when adding, fixing, or optimizing schema markup / structured data. Triggers on "schema markup", "structured data", "JSON-LD", "rich snippets", "FAQ schema", "product schema", "rich results", "star ratings in search".
---
# Structured Data Schema Writer
Structured data tells search engines what a page is, which can unlock rich results (ratings, FAQ accordions, breadcrumbs, product cards). The hard rule: markup must accurately represent what's visibly on the page. Marking up content that isn't there is a guidelines violation and gets the rich results revoked — sometimes the whole site flagged.
## Use JSON-LD
Google recommends JSON-LD (a script block in the head or end of body) over inline microdata — it's easier to maintain and keeps markup separate from the HTML. Default to it.
## Match the type to the page
Pick the schema type from what the page actually is and what rich result it's eligible for:
- **Product / Offer / AggregateRating** — product pages with real reviews
- **FAQPage** — a genuine Q&A section visible on the page
- **BreadcrumbList** — pages within a hierarchy
- **Article / BlogPosting** — editorial content
- **Organization / WebSite** — sitewide identity
Only mark up types that are both true to the page and eligible for a rich result. Don't stack speculative schema.
## Accuracy and upkeep
- Every field must match visible content — same price, same rating, same answer
- Update the markup when the content changes; stale schema (a price that no longer matches) gets flagged
- Validate with Google's Rich Results Test and clear Search Console errors before considering it done
## Anti-patterns
- Marking up content that doesn't appear on the page
- Schema values that contradict what the user sees (price, rating)
- Wrong type for the page just to chase a rich result
- Shipping without validating, then wondering why nothing shows
Example prompts
Once installed, try these prompts in Claude:
- Add Product + Review schema to our product pages so star ratings can show in search.
- Our FAQ schema is throwing errors in Search Console. Diagnose and fix it.