PlugWiki

schema Skill for Claude Code: Add and Fix JSON-LD Structured Data

Adds, fixes and validates schema.org JSON-LD structured data so pages can qualify for Google rich results.

Installs
82.4K
on skills.sh
Stars
57.9K
on GitHub
Files
2
besides SKILL.md
Updated
Oct 2026
last repo commit

schema makes your assistant act as a structured data expert. It looks at the page type, existing markup and your goal, then writes JSON-LD for types such as Organization, Article or BlogPosting, Product, FAQPage and BreadcrumbList. Its rule is to check which features Google currently supports before you add a type: the SKILL.md says Google stopped showing FAQ rich results on May 7, 2026, retired HowTo rich results in September 2023 and retired the sitelinks search box in November 2024.

It covers combining multiple schema types, validation with the Google Rich Results Test, the Schema.org validator and Search Console, and how to implement on static sites, dynamic sites (React, Next.js) and CMS or WordPress. Common errors it names are missing required properties, invalid values and markup that does not match the page. It bundles a schema-examples reference and an evals/evals.json file, and no scripts.

Good for

  • SEO marketers adding product, article or organization markup
  • Developers adding JSON-LD in Next.js, React or static sites
  • WordPress and CMS owners fixing structured data errors

Install schema

Claude Code

  1. 1

    Copy this prompt.

    Install the schema skill in Claude Code. Run this command:

npx skills add https://github.com/coreyhaines31/marketingskills --skill schema

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," or "add structured data." Use this whenever someone wants their pages to show enhanced results in Google. For broader SEO issues, see seo-audit. For AI search optimization, see ai-seo.

Sections in SKILL.md

  1. Initial Assessment
  2. Core Principles
  3. 1. Accuracy First
  4. 2. Use JSON-LD
  5. 3. Follow Google's Guidelines
  6. 4. Validate Everything
  7. Common Schema Types
  8. Check Google Feature Support First
  9. Quick Reference
  10. Organization (Company Page)
  11. Article/BlogPosting
  12. Product
  13. FAQPage
  14. BreadcrumbList
  15. Multiple Schema Types
  16. Validation and Testing

Key facts

Author
Corey Haines
Repo
coreyhaines31/marketingskills
Installs on skills.sh
82,419 (Nov 2, 2026)
GitHub stars (whole repo)
57,855 (Nov 2, 2026)
License
MIT
Last repo commit
Oct 31, 2026
Files in the skill folder
3 files: SKILL.md, evals/evals.json, references/schema-examples.md
skills.sh audits
Gen Agent Trust Hub pass, Socket pass, Snyk pass
Bundled references
schema-examples.md

What it includes

  • Asks about page type, current markup and target rich results

    Initial Assessment

  • Accuracy first, use JSON-LD, follow Google guidelines, validate everything

    Core Principles

  • Confirms a type is supported before you add it

    Check Google Feature Support First

  • Required and recommended fields for common types

    Quick Reference

  • How to combine types on one page

    Multiple Schema Types

  • Rich Results Test, Schema.org Validator and Search Console

    Validation and Testing

  • Static sites, React and Next.js, CMS and WordPress

    Implementation

  • The markup plus a testing checklist

    Output Format

From the official docs

Questions

What does the schema skill do?

It writes and fixes schema.org structured data in JSON-LD. It aims for rich results in Google and keeps markup matched to the visible page.

How do I install the schema skill?

Use the install box at the top of this page. The repo's README also offers a Claude Code plugin called marketing-skills that installs every skill in the collection, and a Codex plugin route for the same set. Pick one skill only if you want just this one. If you ask an agent session to run npx skills for you, the README says to pass -a claude-code, because the CLI may otherwise install only to .agents/skills/, which Claude Code does not read.

Do I need the product-marketing skill first?

No. The schema SKILL.md says to read your product marketing context file if one exists, and to ask you for anything the file does not cover. The README calls product-marketing the foundation that the other skills check first, so it helps to run it once.

Does it validate my markup?

It tells you to test with Google's Rich Results Test, the Schema.org validator and Search Console. It does not run them for you.

How is it different from seo-audit or ai-seo?

The description sends broader SEO issues to seo-audit and AI search optimization to ai-seo. This one only covers structured data.

Does it work in Codex, Cursor or only Claude Code?

The README says the collection works with Claude Code, OpenAI Codex, Cursor, Windsurf, and any agent that supports the Agent Skills spec. It does not list test results per skill.

Is the schema skill safe to install?

It is a markdown skill. The folder bundles reference files and an evals/evals.json file, and no scripts. The SKILL.md names no API key. It changes how your assistant works in your project, so read the SKILL.md if you need to review it first.

Information

updated Nov 2, 2026

Repository
coreyhaines31/marketingskills
Folder
skills/schema

coreyhaines31/marketingskillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3
  1. schema SKILL.md · github.com
  2. marketingskills README · github.com
  3. schema on skills.sh · skills.sh

Updated Nov 2, 2026.