This skill should be used when the user asks to \"add schema markup\", \"generate structured data\", \"JSON-LD\", \"rich snippets\", \"FAQ schema\", \"HowTo schema\", \"Product schema\", \"Article schema\", \"LocalBusiness schema\", \"Organization schema\", \"BreadcrumbList\", \"I want star ratings in Google\", \"rich results\", \"voice search optimization\", \"event markup\", or \"structured data validation errors\". Generates Schema.org JSON-LD for FAQPage, HowTo, Article/BlogPosting, Product, AggregateRating, LocalBusiness, Organization, BreadcrumbList, Event, and Recipe types. Produces validated markup targeting Google Rich Results, Bing structured data, and AI system understanding (FAQ schema improves AI citation chances). Validates against Google Rich Results Test requirements. For broader technical SEO, see technical-seo-checker. For meta tag optimization, see meta-tags-optimizer.
Drops the SKILL.md into .claude/skills/schema-markup-generator.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.
Schema Markup Generator
SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills
This skill creates Schema.org structured data markup in JSON-LD format to help search engines understand your content and enable rich results in SERPs.
When to Use This Skill
Adding FAQ schema for expanded SERP presence
Creating How-To schema for step-by-step content
Adding Product schema for e-commerce pages
Implementing Article schema for blog posts
Adding Local Business schema for location pages
Creating Review/Rating schema
Implementing Organization schema for brand presence
Any page where rich results would improve visibility
What This Skill Does
Schema Type Selection: Recommends appropriate schema types
JSON-LD Generation: Creates valid structured data markup
Property Mapping: Maps your content to schema properties
With ~~web crawler connected:
Automatically crawl and extract page content (visible text, headings, lists, tables), existing schema markup, page metadata, and structured content elements that map to schema properties.
With manual data only:
Ask the user to provide:
Page URL or full HTML content
Page type (article, product, FAQ, how-to, local business, etc.)
Specific data needed for schema (prices, dates, author info, Q&A pairs, etc.)
Current schema markup (if optimizing existing)
Proceed with the full workflow using provided data. Note in the output which data is from automated extraction vs. user-provided data.
Instructions
When a user requests schema markup:
Identify Content Type and Rich Result Opportunity
Reference the CORE-EEAT Benchmark item O05 (Schema Markup) for content-type to schema mapping:
Source of each data point clearly stated (~~web crawler extraction, user-provided, or manual entry)
Example
User: "Generate FAQ schema for a page about SEO with 3 questions"
Output:
## FAQ Schema for SEO Page
### Schema Markup
```json
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO (Search Engine Optimization) is the practice of optimizing websites and content to rank higher in search engine results pages (SERPs). It involves technical optimizations, content creation, and link building to increase organic visibility and drive qualified traffic to your website."
}
},
{
"@type": "Question",
"name": "How long does SEO take to work?",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO typically takes 3-6 months to show significant results, though this varies based on competition, domain authority, and effort invested. New websites may take 6-12 months, while established sites with existing authority can see improvements in 1-3 months for less competitive keywords."
}
},
{
"@type": "Question",
"name": "Is SEO better than paid advertising?",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO and paid advertising serve different purposes. SEO provides sustainable, long-term traffic without per-click costs but takes time to build. Paid advertising delivers immediate results but stops when you stop paying. Most successful businesses use both: paid ads for immediate leads and SEO for long-term growth."
}
}
]
}
Implementation: Wrap the above JSON-LD in <script type="application/ld+json">...</script> and place in <head> or before </body>. Test with ~~schema validator.
SERP Preview
SEO Guide: Complete Beginner's Tutorial
yoursite.com/seo-guide/
Learn SEO from scratch with our comprehensive guide...
▼ What is SEO?
SEO (Search Engine Optimization) is the practice of optimizing...
▼ How long does SEO take to work?
SEO typically takes 3-6 months to show significant results...
▼ Is SEO better than paid advertising?
SEO and paid advertising serve different purposes...
## Schema Type Quick Reference
| Content Type | Schema Type | Key Properties |
|--------------|-------------|----------------|
| Blog Post | BlogPosting/Article | headline, datePublished, author |
| Product | Product | name, price, availability |
| FAQ | FAQPage | Question, Answer |
| How-To | HowTo | step, totalTime |
| Local Business | LocalBusiness | address, geo, openingHours |
| Recipe | Recipe | ingredients, cookTime |
| Event | Event | startDate, location |
| Video | VideoObject | uploadDate, duration |
| Course | Course | provider, name |
| Review | Review | itemReviewed, ratingValue |
## Tips for Success
1. **Match visible content** - Schema must reflect what users see
2. **Don't spam** - Only add schema for relevant content
3. **Keep updated** - Update dates and prices when they change
4. **Test thoroughly** - Validate before deploying
5. **Monitor Search Console** - Watch for errors and warnings
## Schema Type Decision Tree
> **Reference**: See [references/schema-decision-tree.md](./references/schema-decision-tree.md) for the full decision tree (content-to-schema mapping), industry-specific recommendations, implementation priority tiers (P0-P4), and validation quick reference.
## Reference Materials
- [Schema Templates](./references/schema-templates.md) - Copy-ready JSON-LD templates for all schema types
- [Validation Guide](./references/validation-guide.md) - Common errors, required properties, testing workflow
## Related Skills
- [seo-content-writer](../seo-content-writer/) — Create content worth marking up
- [on-page-seo-auditor](../../optimize/on-page-seo-auditor/) — Audit existing schema
- [technical-seo-checker](../../optimize/technical-seo-checker/) — Technical validation
- [entity-optimizer](../../cross-cutting/entity-optimizer/) — Entity audit informs Organization, Person, Product schema