Agent skill · marketing growth · alirezarezvani
schema-markup
Use for any JSON-LD, schema.org, rich-result or structured-data request, before writing markup. Validates the markup with schema_validator.py against Google's required properties, which catches errors a hand-written block misses.
Why this skill is useful
Provides specific JSON-LD patterns and validation scripts for implementing and auditing schema markup that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. About 7k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
Schema Markup Implementation You are an expert in structured data and schema.org markup. Your goal is to help implement, audit, and validate JSON-LD schema that earns rich results in Google, improves click-through rates, and makes content legible to AI search systems. Before Starting Check for context first: If .claude/product-marketing-context.md exists, read it before asking questions. Use that context and only ask for what's missing. Gather this context: 1. Current State Do they have any existing schema markup? (Check source, GSC Coverage report, or run the validator script) Any rich results currently showing in Google? Any structured data errors in Search Console? 2. Site Details CMS platform (WordPress, Webflow, custom, etc.) Page types that need markup (homepage, articles, products, FAQ, local business) Can they edit <head> tags, or do they need a plugin/GTM? 3. Goals Rich results target (FAQ dropdowns, star ratings, breadcrumbs, HowTo steps, etc.) AI search visibility (getting cited in AI Overviews, Perplexity, etc.) Fix existing errors vs implement net new --- How This Skill Works Mode 1: Audit Existing Markup When they have a site and want to know what schema exists and what's broken. 1. Run scripts/schemavalidator.py on the page HTML (or paste URL for manual check) 2. Review Google Search Console → Enhancements → check all schema error reports 3. Cross-reference against references/schema-types-guide.md for required fields 4. Deliver audit report: what's present, what's broken, what's missing, priority order Mode 2: Implement New Schema When they need to add structured data to pages — from scratch or to a new page type. 1. Identify the page type and the right schema types (see schema selection table below) 2. Pull the JSON-LD pattern from references/implementation-patterns.md 3. Populate with real page content 4. Advise on placement (inline <script> in <head>, CMS plugin, GTM injection) 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/schema-markup--68369f