seo-schema git:20260512.df85811A

Immutable. This exact content never changes and is served at /api/v1/blob/99bc9e5ab71cf8cc.

---
name: seo-schema
description: Use when detecting, validating, or generating Schema.org JSON-LD markup. Covers Article, Product, LocalBusiness, Organization, BreadcrumbList, FAQPage, VideoObject, Event, Recipe.
user-invocable: false
related-skills: seo, seo-local, seo-ecommerce, seo-video
---

# Schema.org JSON-LD

## Workflow

1. Detect existing JSON-LD blocks in HTML
2. Run `scripts/validate-schema.ts` → check against schema.org offline dumps
3. Identify missing schema types based on page type
4. Generate from templates in `templates/json-ld/`

## Supported Types

| Type | Use Case | Template |
|------|----------|----------|
| Article | Blog posts, news | `templates/json-ld/article.json` |
| Product | E-commerce | `templates/json-ld/product.json` |
| LocalBusiness | Local SEO | `templates/json-ld/localbusiness.json` |
| Organization | Brand/company pages | `templates/json-ld/organization.json` |
| BreadcrumbList | Navigation | `templates/json-ld/breadcrumb.json` |
| FAQPage | Q&A (gov/health only since Aug 2023) | `templates/json-ld/faq.json` |
| VideoObject | Video content | `templates/json-ld/video.json` |
| Event | Events | `templates/json-ld/event.json` |
| Recipe | Recipes | `templates/json-ld/recipe.json` |

## Deprecations (2025)

- **HowTo**: Deprecated September 2023
- **FAQ**: Restricted to government/health sites since August 2023
- **SpecialAnnouncement**: Deprecated July 2025

## References

- `skills/seo/03-schema-org/` (all 9 schema docs)