structured-datalisted
Install: claude install-skill visibian/seo-geo-skills
# Structured data
Write correct JSON-LD that describes what a page is, keep it true to what the page shows, and be exact about what it does and does not do for AI answers.
## What to tell the user first
Structured data helps search engines read a page's facts. Google calls it useful and says there is "no special schema.org structured data" needed for its AI features; tests so far found no clear rise in AI citations from adding it. Details, with sources and dates, are in `references/evidence.md`. Recommend it as good practice for search and for keeping facts consistent, never as a way to get named by an assistant.
## Steps
1. Find what exists. In a codebase, search for `application/ld+json`, `schema.org`, and framework helpers (for example `next-seo`, a `JsonLd` component, Yoast or Rank Math settings in WordPress, a Shopify theme's `structured-data` snippets). On a live page, run from this skill's folder:
`python3 scripts/check_jsonld.py https://example.com/page`
or point it at a built HTML file. It reads the raw HTML, the way a crawler that runs no scripts sees the page.
2. Pick the types that match what the page really is. Use `references/types.md` for the right type per page and a template for each. One page usually needs one main node, plus Organization and WebSite once on the home page, and BreadcrumbList on inner pages.
3. Fill in only facts that are on the page. Google asks that everything in the markup be visible on the page. Never add ratings, reviews, pric