schema-markup-generator

0
0
Source

Generates structured data markup (Schema.org JSON-LD) to enable rich results in search engines including FAQ snippets, How-To cards, Product listings, Reviews, and more.

Install

mkdir -p .claude/skills/schema-markup-generator && curl -L -o skill.zip "https://mcp.directory/api/skills/download/8383" && unzip -o skill.zip -d .claude/skills/schema-markup-generator && rm skill.zip

Installs to .claude/skills/schema-markup-generator

About this skill

Schema Markup Generator

Generate valid JSON-LD structured data in seconds and unlock rich results in Google — describe your page (or paste a URL) and this skill selects the right schema types, maps your content to all required properties, and outputs copy-paste-ready markup with a SERP preview showing what your rich result will look like.

Quick example: Generate FAQ schema for a page about SEO with 3 questions → get validated JSON-LD, an implementation guide for <head> or </body>, and a live SERP preview of the expanded result.

System role: Build layer skill. It turns briefs and signals into assets that other skills can review, publish, and monitor.

Part of the SEO & GEO Skills Library · 20 skills · ClawHub · skills.sh

When This Must Trigger

Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:

Use this whenever the task needs a shippable asset or transformation that should feed directly into quality review, deployment, or monitoring.

  • 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

Quick Start

Start with one of these prompts. Finish with a short handoff summary using the repository format in Skill Contract.

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]

Skill Contract

Expected output: a ready-to-use asset or implementation-ready transformation plus a short handoff summary ready for memory/content/.

  • Reads: the brief, target keywords, entity inputs, quality constraints, and prior decisions from CLAUDE.md and the shared State Model when available.
  • Writes: a user-facing content, metadata, or schema deliverable plus a reusable summary that can be stored under memory/content/.
  • Promotes: approved angles, messaging choices, missing evidence, and publish blockers to CLAUDE.md, memory/decisions.md, and memory/open-loops.md.
  • Next handoff: use the Next Best Skill below when the asset is ready for review or deployment.

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:

    ### 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).*
    
    ### 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]
    
  2. 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 <script type="application/ld+json"> tag.

  3. Provide Implementation and Validation

    ## Implementation Guide
    
    ### Adding Schema to Your Page
    
    **Option 1: In HTML <head>**
    ```html
    <head>
      <script type="application/ld+json">
        [Your JSON-LD schema here]
      </script>
    </head>
    

    Option 2: Before closing </body>

      <script type="application/ld+json">
        [Your JSON-LD schema here]
      </script>
    </body>
    

    Validation Steps

    1. ~~schema validator

      • Test your live URL or paste code
      • Check for errors and warnings
    2. Schema.org Validator

    3. ~~search console

      • Monitor rich results in ~~search console
      • Check Enhancements reports for issues

    Validation Checklist

    • JSON syntax is valid (no trailing commas)
    • All required properties present
    • URLs are absolute, not relative
    • Dates are in ISO 8601 format
    • Content matches visible page content
    • No policy violations

Validation Checkpoints

Input Validation

  • Page URL or content provided
  • Schema type appropriate for content (Article for blog, Product for e-commerce, etc.)
  • All required data available (author, dates, prices, etc. depending on schema type)
  • Content eligibility for rich results confirmed

Output Validation

  • JSON syntax validates (no trailing commas, proper quotes)
  • All required properties present for chosen schema type
  • URLs are absolute, not relative
  • Dates in ISO 8601 format (YYYY-MM-DDTHH:MM:SS+00:00)
  • Schema content matches visible page content exactly
  • Passes ~~schema validator with no errors
  • 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

---

*Content truncated.*

You might also like

flutter-development

aj-geddes

Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.

9521,094

drawio-diagrams-enhanced

jgtolentino

Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.

846846

ui-ux-pro-max

nextlevelbuilder

"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."

571699

godot

bfollington

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

548492

nano-banana-pro

garg-aayush

Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.

673466

fastapi-templates

wshobson

Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.

514280

Stay ahead of the MCP ecosystem

Get weekly updates on new skills and servers.