schema-markuplisted
Install: claude install-skill mdnaimul22/human-skills
# 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 `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/schema_validator.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 f