--- name: schema-markup-generator version: "4.0.0" description: 'Generate Schema.org JSON-LD structured data for FAQ, HowTo, Article, Product, LocalBusiness, and 6 other types targeting rich results. Use when the user asks to "add schema markup", "generate structured data", "JSON-LD", "FAQ schema", "rich snippets", "I want star ratings in Google", or "structured data validation errors". Produces validated markup targeting Google Rich Results, Bing structured data, and AI system understanding. Validates against Google Rich Results Test requirements. For broader technical SEO, see technical-seo-checker. For meta tag optimization, see meta-tags-optimizer.' license: Apache-2.0 compatibility: "Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations." homepage: "https://github.com/aaron-he-zhu/seo-geo-claude-skills" allowed-tools: WebFetch metadata: author: aaron-he-zhu version: "4.0.0" geo-relevance: "medium" tags: - seo - structured-data - json-ld - rich-results - rich-snippets - faq-schema - howto-schema - product-schema - article-schema - localbusiness-schema - schema-org triggers: - "add schema markup" - "generate structured data" - "JSON-LD" - "rich snippets" - "FAQ schema" - "schema.org" - "structured data markup" - "add FAQ rich results" - "I want star ratings in Google" - "product markup" - "recipe schema" ---

Schema Markup Generator

> SEO & GEO Skills Library · 20 skills for SEO + GEO · ClawHub · skills.sh

Browse all 20 skills

Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis

Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator

Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher

Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager

Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management

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

1. Schema Type Selection: Recommends appropriate schema types
2. JSON-LD Generation: Creates valid structured data markup
3. Property Mapping: Maps your content to schema properties
4. Validation Guidance: Ensures schema meets requirements
5. Nested Schema: Handles complex, multi-type schemas
6. Rich Result Eligibility: Identifies which rich results you can target

How to Use

Generate Schema for Content

Generate schema markup for this [content type]: [content/URL]

Create FAQ schema for these questions and answers: [Q&A list]

Specific Schema Types

Create Product schema for [product name] with [details]

Generate LocalBusiness schema for [business name and details]

Audit Existing Schema

Review and improve this schema markup: [existing schema]

Data Sources

> See CONNECTORS.md for tool category placeholders.

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:

1. Page URL or full HTML content
2. Page type (article, product, FAQ, how-to, local business, etc.)
3. Specific data needed for schema (prices, dates, author info, Q&A pairs, etc.)
4. 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:

1. Identify Content Type and Rich Result Opportunity

Reference the CORE-EEAT Benchmark item O05 (Schema Markup) for content-type to schema mapping:

```markdown ### CORE-EEAT Schema Mapping (O05)

| Content Type | Required Schema | Conditional Schema | |-------------|----------------|--------------------| | Blog (guides) | Article, Breadcrumb | FAQ, HowTo | | Blog (tools) | Article, Breadcrumb | FAQ, Review | | Blog (insights) | Article, Breadcrumb | FAQ | | Alternative | Comparison*, Breadcrumb, FAQ | AggregateRating | | Best-of | ItemList, Breadcrumb, FAQ | AggregateRating per tool | | Use-case | WebPage, Breadcrumb, FAQ | — | | FAQ | FAQPage, Breadcrumb | — | | Landing | SoftwareApplication, Breadcrumb, FAQ | WebPage | | Testimonial | Review, Breadcrumb | FAQ, Person |

Use the mapping above to ensure schema type matches content type (CORE-EEAT O05: Pass criteria). ```

```markdown ### Schema Analysis

Content Type: [blog/product/FAQ/how-to/local business/etc.] Page URL: [URL]

Eligible Rich Results:

| Rich Result Type | Eligibility | Impact | |------------------|-------------|--------| | FAQ | ✅/❌ | High - Expands SERP presence | | How-To | ✅/❌ | Medium - Shows steps in SERP | | Product | ✅/❌ | High - Shows price, availability | | Review | ✅/❌ | High - Shows star ratings | | Article | ✅/❌ | Medium - Shows publish date, author | | Breadcrumb | ✅/❌ | Medium - Shows navigation path | | Video | ✅/❌ | High - Shows video thumbnail |

Recommended Schema Types: 1. [Primary schema type] - [reason] 2. [Secondary schema type] - [reason] ```

1. Generate Schema Markup

Based on the identified content type, generate the appropriate JSON-LD schema. Supported types: FAQPage, HowTo, Article/BlogPosting/NewsArticle, Product, LocalBusiness, Organization, BreadcrumbList, Event, Recipe, and combined multi-type schemas.

> Reference: See references/schema-templates.md for complete, copy-ready JSON-LD templates for all schema types with required and optional properties.

For each schema generated, include: - All required properties for the chosen type - Rich result preview showing expected SERP appearance - Notes on which properties are required vs. optional

When combining multiple schema types on one page, wrap them in a JSON array inside a single