structured-data
/structured-data
Designs, writes and validates JSON-LD structured data (schema.org) for websites. Builds one connected @graph per page (Organization or LocalBusiness, WebSite, WebPage, BreadcrumbList, Service, Product, Article, FAQPage, SoftwareApplication, Event) linked by stable @id values and generated at build time; scripts/jsonld-check.mjs checks every page of a build or live site for parse errors, unresolved @id references, required and recommended properties, absolute URLs and ISO dates. Use it when adding schema markup, chasing rich results, fixing Search Console structured-data errors, or making a bus
- Author
- sharabarinillia ↗
- Repository
- SEO-GEO-Vercel-Playbook-Skill ↗
- Licence
- MIT
- Last repository change
- 11.11.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 5
No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 2 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/jsonld-check.mjs, scripts/site-files.mjs
What it does and when to use it
Designs, writes and validates JSON-LD structured data (schema.org) for websites. Builds one connected @graph per page (Organization or LocalBusiness, WebSite, WebPage, BreadcrumbList, Service, Product, Article, FAQPage, SoftwareApplication, Event) linked by stable @id values and generated at build time; scripts/jsonld-check.mjs checks every page of a build or live site for parse errors, unresolved @id references, required and recommended properties, absolute URLs and ISO dates. Use it when adding schema markup, chasing rich results, fixing Search Console structured-data errors, or making a bus
Original author description
Designs, writes and validates JSON-LD structured data (schema.org) for websites. Builds one connected @graph per page (Organization or LocalBusiness, WebSite, WebPage, BreadcrumbList, Service, Product, Article, FAQPage, SoftwareApplication, Event) linked by stable @id values and generated at build time; scripts/jsonld-check.mjs checks every page of a build or live site for parse errors, unresolved @id references, required and recommended properties, absolute URLs and ISO dates. Use it when adding schema markup, chasing rich results, fixing Search Console structured-data errors, or making a bus
How it works
- Principles
- Steps
- What to expect from rich results
- Don'ts
SKILL.md preview
---
name: structured-data
description: >
Designs, writes and validates JSON-LD structured data (schema.org) for websites. Builds one
connected @graph per page (Organization or LocalBusiness, WebSite, WebPage, BreadcrumbList,
Service, Product, Article, FAQPage, SoftwareApplication, Event) linked by stable @id values and
generated at build time; scripts/jsonld-check.mjs checks every page of a build or live site for
parse errors, unresolved @id references, required and recommended properties, absolute URLs and
ISO dates. Use it when adding schema markup, chasing rich results, fixing Search Console
structured-data errors, or making a business's facts (address, services, opening hours,
certifications) machine-readable for search engines and AI assistants.
license: MIT
compatibility: jsonld-check.mjs needs Node.js 18 or later.
metadata:
author: Illia Sharabarin
version: "1.0.0"
updated: "2026-11-05"
---
# Structured data (JSON-LD)
Structured data tells machines what a page is about: which business, which service, which
answer. It drives rich results where Google still shows them, and it helps search engines and AI
assistants read facts without guessing. Google says it is not required for its AI features, but
it costs little when it is generated from the same data as the page.
## Principles
1. **One `@graph` per page**, in one `<script type="application/ld+json">` block, generated at
build time with `JSON.stringify` (never by string concatenation).
2. **Stable `@id`s** link the nodes: `https://www.example.com/#org` for the business on every page,
`#website`, and `<page URL>#webpage` per page. Reference with `{ "@id": "…" }`.
3. **Every page's graph is self-contained**: if a node is referenced, it is defined on that page
(repeat the Organization node; it's small).
4. **Facts only, and the same facts as the page.** Markup that claims what the page doesn't show
(reviews, prices, hours) breaks Google's guidelines and gets repeated by AI assistants.
5. **`dateModified` comes from the same source as the sitemap's `lastmod`**, the date the visible
content last changed.
6. **Absolute URLs, ISO 8601 dates** (`2026-11-05` or `2026-11-05T09:30:00+01:00`).
## Steps
1. **Pick the types.** Organization or a LocalBusiness subtype (one business, everywhere); WebSite;
WebPage (or AboutPage, ContactPage, CollectionPage) per page; BreadcrumbList on inner pages;
then the page's own node: Service, Product, Article, SoftwareApplication (free tools), Event,
FAQPage (questions answered on the page), DefinedTermSet (glossaries, reference charts).
Patterns: [references/graph-patterns.md](references/graph-patterns.md).
2. **Start from the template** [assets/graph-template.json](assets/graph-template.json) and fill
it from the site's content data, not by hand per page.
3. **Generate it in the build** (a template partial, a Vite/Astro plugin, or `generateMetadata` in
Next.js) and inject it into the `<head>`.
4. **Validate every page:**
```bash
node <skill>/scripts/jsonld-check.mjs --dir dist # build folder
node <skill>/scripts/jsonld-check.mjs --sitemap https://www.example.com/sitemap.xml
```
Errors (parse failures, unresolved `@id`s, missing required properties, relative URLs, bad
dates) must be fixed; make the build fail on them. Warnings list recommended properties: add
one only when the fact is confirmed (no opening hours you don't have).
5. **Spot-check rich results** for 3–5 key pages in Google's
[Rich Results Test](https://search.google.com/test/rich-results) and the
[Schema Markup Validator](https://validator.schema.org/).
6. **After launch,** watch Search Console's enhancement reports for errors.
## What to expect from rich results
Google's supported rich results change often; check the
[Search Gallery](https://developers.google.com/search/docs/appearance/structured-data/search-gallery)
before promising one. Notes as of November 2026 are in
[references/rich-results.md](references/rich-results.md). Markup Google no longer shows does no harm
and still describes the page to other consumers.
## Don'ts
- No markup for content that isn't visible on the page.
- No fake or self-written reviews and ratings.
- No `LocalBusiness` without a real address the business confirms.
- No separate, conflicting graphs from plugins and hand-written blocks on one page: merge them.
Files in this package (6)
- SKILL.md 4 KB
- assets/graph-template.json 3 KB
- references/graph-patterns.md 4 KB
- references/rich-results.md 2 KB
- scripts/jsonld-check.mjs 12 KB
- scripts/site-files.mjs 11 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · sharabarinillia/SEO-GEO-Vercel-Playbook-Skill | 100 | MIT |
| adobe/skills | 100 | Apache-2.0 |
| devpilotX/ai-skill-ai | 100 | MIT |
| thedaviddias/front-end-checklist | 100 | MIT |
Database snapshot: 13.11.2026 · package version 48771e9d8d45 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90schema
Generates valid schema.org JSON-LD structured data (Organization, WebSite, LocalBusiness, Product/Offer, Article, BreadcrumbList, FAQPage, Event, Service, SoftwareApplication, Review) from a page, a model or a description, and wires it into the project's templates. Use when the… - 100structured-data-for-ai-search
Use when the user wants to add, fix, or validate structured data (JSON-LD, schema.org) so search engines and AI answer engines read a page correctly: which types belong on which page, which properties Google requires, and whether the markup matches what the page shows. Also use… - 100clickd-schema-markup
Generates, wires and validates JSON-LD structured data (Organization, LocalBusiness, Product, Service, Article, FAQPage, BreadcrumbList and WebSite) from the visible facts on a site's pages, and checks every page with clickd. Use when asked to add or fix schema.org JSON-LD… - 100schema-markup
Adds, repairs and verifies schema.org structured data (JSON-LD) on a website, and says honestly which Google rich results the markup can still earn. Use when a user asks to "add schema markup", "add structured data", "write JSON-LD for this page", "fix structured data errors in… - 100schema
Use this skill for structured data and schema markup questions. Triggers on: JSON-LD, schema.org, structured data, rich snippets, rich results, FAQ schema, Product schema, Article schema, Organization schema, Review schema, LocalBusiness schema, HowTo schema, BreadcrumbList… - 100seo-schema
Detect existing JSON-LD structured data on a page, validate against Google's rich-result requirements, and generate missing schema markup (Article, Product, LocalBusiness, FAQPage, BreadcrumbList). Produces paste-ready JSON-LD script blocks. Use when the user asks for "schema…