schema
An agent skill by coreyhaines31, from coreyhaines31/marketingskills. Tags: markup, search, seo, validation, web.
What it does
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.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add coreyhaines31/marketingskills --skill schema
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/coreyhaines31/marketingskills
cp -r marketingskills/skills/schema ~/.claude/skills/schema
Safety box score
Grade A, minimal risk: 7 of 100 risk points, rated 2026-10-15. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This is a documentation-only schema markup skill: it generates JSON-LD guidance and examples for website pages, with no scripts, installers, or privileged actions. The main exposure is limited local file reads for optional marketing context and the user choosing to send markup to third-party validation tools like Google’s Rich Results Test or Search Console.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 0 (none) | No shell commands, code execution, eval, or installers are shipped; the files are plain Markdown with JSON-LD examples. |
| Network access | 1 (low) | It points users to external services such as Google Rich Results Test, Schema.org Validator, and Search Console, so markup may be sent off-machine if the guidance is followed. |
| Filesystem reach | 1 (low) | The skill explicitly reads optional local files like `.agents/product-marketing.md`, `.claude/product-marketing.md`, or `product-marketing-context.md`, but it does not write or delete files. |
| Secrets & credentials | 0 (none) | There is no mention of tokens, passwords, `.env` files, keychains, browser sessions, or other credential stores. |
| Privilege & persistence | 0 (none) | No sudo, global installs, services, scheduled tasks, or OS/shell settings changes are requested. |
| Instruction hijack surface | 0 (none) | The skill does not tell the agent to ignore higher-priority instructions or follow remote content; it focuses on schema guidance and feature-support caveats. |
| Irreversible actions | 0 (none) | It does not publish, deploy, post, pay, book, or delete anything; it only prepares markup for the user to apply. |
| Transparency | 0 (none) | All shipped files are readable Markdown/JSON examples; there are no binaries, hidden blobs, or decoded-at-runtime code paths. |
Before installing
- Check whether `.agents/product-marketing.md` or `.claude/product-marketing.md` contains anything sensitive, since the skill will read it first.
- Confirm you’re okay using Google Rich Results Test, Schema.org Validator, and Search Console with your markup.
- Review `references/schema-examples.md` if you want to verify the Next.js JSON-LD escaping example before adopting it.
Rated 2026-10-15 by an automated review of 3 files from the skill's repository.
Source
- Repository
- coreyhaines31/marketingskills (all skills from this repository)
- Path
- skills/schema/SKILL.md
- Branch
- main
- Collection
- marketingskills
- Updated
- 2026-09-21
Related skills
- seo — Comprehensive SEO analysis for any website or business type.
- seo-geo — Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences.
- seo-hreflang — Hreflang and international SEO audit, validation, and generation.
- seo-local — Local SEO analysis covering Google Business Profile optimization, NAP consistency, citation health, review signals, local schema markup, location page quality.
- seo-page — Deep single-page SEO analysis covering on-page elements, content quality, technical meta tags, schema, images, and performance.
- seo-schema — Detect, validate, and generate Schema.org structured data. JSON-LD format preferred. Use when user says "schema", "structured data", "rich results", "JSON-LD".