Skip to content
Skills Library
Marketing & content · Building & coding

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

Licence
MIT
Last repository change
11.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
2
HTML comments
0
URLs in SKILL.md
5
Deprecation

No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

  1. Principles
  2. Steps
  3. What to expect from rich results
  4. Don'ts
Original SKILL.md headings · 63 lines, 457 words
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

RepositoryScoreLicence
This page · sharabarinillia/SEO-GEO-Vercel-Playbook-Skill100MIT
adobe/skills100Apache-2.0
devpilotX/ai-skill-ai100MIT
thedaviddias/front-end-checklist100MIT

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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.