| name | fix-schema |
| parent | best-aeo-skill |
| description | Generate JSON-LD structured data. Auto-creates FAQPage (highest AI citation surface), Article, Organization, HowTo, Speakable, Product, BreadcrumbList, Person schemas. Validates with Schema.org. Use when the user asks for "schema", "structured data", "JSON-LD", "FAQ schema", or "rich results markup". |
fix-schema — sub-skill
Generate, validate, and inject JSON-LD structured data for the highest AI citation surfaces.
When to invoke
- "Add FAQPage schema to /pricing"
- "Generate Article schema for my blog post"
- "Create Organization markup with Wikidata sameAs"
- "Validate my structured data"
Schemas supported (priority order)
- FAQPage — highest AI citation surface (Rule 36)
- Article / BlogPosting / NewsArticle — required for content pages
- Organization with sameAs to Wikidata/Wikipedia/LinkedIn (Rule 42)
- HowTo — for tutorials
- Speakable — for AI voice surfaces (Google AI Overviews)
- Product + AggregateRating + offers
- BreadcrumbList
- Person (author bios)
- VideoObject + Clip + SeekToAction
- LocalBusiness + GeoCoordinates
Validation
- Schema.org compliance check
- Google Rich Results structured data eligibility
- Required fields verification
- Cross-schema consistency
Inputs
--url <URL> or --file <path>--types <list> — comma-separated (e.g., faq,article,org)--apply — inject into HTML; without flag = print blocks only
Run
python3 scripts/fix_schema.py --url https://example.com --types faq,article,org
