Schema Markup Builder

What it does

Reads the post type and content, then drafts JSON-LD schema (Article, HowTo, Review, or FAQPage) with the required and recommended properties filled from the actual post data. Validates the draft against a mental checklist, required fields for that type, before handing it to the user, and flags any property it had to guess.

Install

This skill isn't packaged in an installable registry. It's a plain SKILL.md file you can copy directly. Copy it from the SKILL.md tab and save it at the path for your assistant:

Use it in your AI assistant

Claude Code

.claude/skills/schema-markup-builder/ (or ~/.claude/skills/schema-markup-builder/ for all projects)

GitHub Copilot (VS Code)

.github/skills/schema-markup-builder/

OpenAI Codex

.codex/skills/schema-markup-builder/

Cursor

.cursor/skills/schema-markup-builder/ (or ~/.cursor/skills/schema-markup-builder/ globally)

Compatibility

Any WordPress site. If an SEO plugin (Yoast, Rank Math, SEOPress) is active, the schema is added through its custom schema/JSON-LD field; otherwise it is inserted as a code block via a custom HTML block or the theme's header.

The complete SKILL.md for this skill:

---
name: schema-markup-builder
description: Use when a user asks to add structured data, schema markup, or JSON-LD to a WordPress post or page, or asks "will this show up as a rich result". Triggers on "schema markup", "JSON-LD", "structured data", or "rich snippet".
---

# Schema Markup Builder

## When to use
The user wants a post or page to carry structured data, for example an Article, HowTo, Review, or FAQPage schema, so it can qualify for a rich result in search.

## Procedure
1. Identify the content type (article, recipe-style how-to, product review, FAQ list) from the post's structure and confirm with the user if it's ambiguous.
2. Map the required properties for that schema type (e.g. headline, datePublished, author for Article; step list for HowTo; ratingValue and reviewCount for Review) to the actual content on the page.
3. Draft the JSON-LD block, leaving a clearly marked placeholder for any value that isn't present in the content rather than inventing one.
4. Show the user the rendered JSON-LD and a plain-language summary of what each property maps to.
5. On approval, insert it via the site's SEO plugin schema field if one is active, or as a script block in a custom HTML block if not.

## Guardrails
- Never fabricate review counts, ratings, prices, or dates that aren't already published on the page, that risks a manual action for misleading markup.
- Flag when a schema type (like Review or Product) has eligibility requirements, such as visible reviews on the page, that the content doesn't currently meet.