Schema Markup

Overview

Structured data is a machine-readable description of what a page is about: a script element of type application/ld+json holding schema.org types and properties. Search engines read it to understand entities (who published this, what is sold, at what price) and Google uses a subset of it to draw rich results such as price and rating lines, breadcrumbs, event listings and video previews.

This skill produces three things: a decision about which types belong on each page template, the JSON-LD itself wired into the project's code, and a verification report. It is deliberately strict about what the markup can earn, because Google retired a long list of rich results between 2023 and 2026 and much advice online still promises them.

Instructions

1. Read the page before writing anything

Collect these facts from the project, and ask the user only for what the code cannot tell you:

• The stack and where the document head is rendered (Next.js app/ layouts, an Astro or Eleventy layout, a WordPress theme or SEO plugin, a Shopify theme).
• One live URL or local build output per page template: home, article, product, pricing, location, event.
• What is already there. Save the checker below as jsonld_check.py and run it against each URL or built HTML file.
• Whether the facts the markup will state are visible on the page: price, rating and count, author, dates, address, opening hours. Markup may only repeat what a visitor can see.