# seo-schema

> Detect, validate, and generate Schema.org structured data in JSON-LD format, with deprecation status tracking and ready-to-use templates for all active rich result types as of February 2026.

**Use case**: Validate schema and generate rich-result-ready JSON-LD

**Canonical URL**: https://agentcookbooks.com/skills/seo-schema/

**Topics**: claude-code, skills, marketing, seo

**Trigger phrases**: "schema", "structured data", "rich results", "JSON-LD", "markup"

**Source**: [AgriciDaniel](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo-schema)

**License**: MIT

---

## What it does

`seo-schema` is a Claude Code skill from AgriciDaniel's [claude-seo repo](https://github.com/AgriciDaniel/claude-seo). It detects structured data from three implementation formats (JSON-LD, Microdata, RDFa), validates against Google's supported rich result types including current deprecation status, and generates ready-to-use JSON-LD templates for any active schema type.

The skill maintains a current deprecation list: HowTo (rich results removed September 2023), SpecialAnnouncement (deprecated July 2025), VehicleListing (retired June 2025), ClaimReview (retired June 2025), Dataset (retired late 2025), and several others. It also tracks restriction status: FAQ is restricted to government and healthcare sites only since August 2023, and adding new FAQ markup on commercial sites is not recommended for Google rich result benefit (though it retains some AI/LLM citation benefit). The December 2025 JavaScript SEO guidance note is included: structured data injected via JavaScript may face delayed processing, and Product markup in particular should be in the initial server-rendered HTML.

## When to use it

Reach for it when:

- A product or article page is not generating rich results and you want to find the exact schema property causing the failure
- You want to generate correct Organization, LocalBusiness, Article, or SoftwareApplication JSON-LD for a new page
- You inherited a site and need to audit for deprecated schema types that should be removed

When *not* to reach for it:

- The URL is behind authentication; the skill fetches and parses live pages
- You want Product schema for e-commerce specifically — `seo-ecommerce` covers Product schema with Google Merchant Center validation and the full recommended-property scoring ladder

## Install

Copy the [`seo-schema` SKILL.md](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo-schema) into `.claude/skills/seo-schema/`.

Trigger phrases: "schema", "structured data", "rich results", "JSON-LD", "markup".

Invoke with `/seo schema <url>` to detect and validate existing schema, or describe the page type to generate new JSON-LD. Output files: `SCHEMA-REPORT.md` and `generated-schema.json`.

## What a session looks like

A typical session has three phases:

1. **Detection and format audit.** The skill scans for all three implementation formats. JSON-LD is always recommended as primary (Google's stated preference). Microdata and RDFa findings are noted with a migration suggestion if they are the only format present.
2. **Validation against Google's spec.** Each detected schema type is checked for required and recommended properties, valid data types, absolute (not relative) URLs, ISO 8601 dates, placeholder text, and missing `@context`. Deprecated types are flagged with their retirement date and recommended replacement. The validation table shows pass/warn/fail per schema block.
3. **Generation and recommendations.** Missing schema opportunities are identified from page content (an article page without Article schema, a local business page without LocalBusiness schema). Ready-to-use JSON-LD templates are generated with all required properties populated and recommended properties marked as placeholders — no HowTo, no FAQ for commercial sites.

## Receipts

**Works well:** The deprecation tracking is the most time-sensitive value this skill provides — the list of deprecated schema types updated several times in 2024 and 2025. Finding a site still using HowTo or VehicleListing markup is common on sites that set schema once and never revisited it.

**Backfires:** The December 2025 guidance on JavaScript-injected structured data requires knowing whether the site is SSR or CSR — the skill identifies client-side rendering patterns and flags the risk, but verifying whether the specific schema block is in the initial HTML response requires checking the raw HTML source directly.

**Pattern that works:** Add Organization schema to the homepage first, then Article/BlogPosting schema to all content pages, then page-type-specific schema to product or service pages. Organization schema is the fastest win because it is site-wide and helps AI systems understand entity relationships for GEO.

## Source and attribution

Originally written by [AgriciDaniel](https://github.com/AgriciDaniel). The canonical SKILL.md and supporting templates live in the [`seo-schema` folder](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo-schema) of the [claude-seo repository](https://github.com/AgriciDaniel/claude-seo).

License: MIT. Install, adapt, and redistribute with attribution preserved.

This page documents the skill from a practitioner's perspective. For the formal spec and updates, defer to the source repo.