Agent Skills

SEO Schema — structured data & meta markup

Use this skill for the markup layer of SEO: structured data (JSON-LD / schema.org) and meta tags (title, description, Open Graph, Twitter Cards).

Commands (documented in commands/)

Command	What it does
seo-schema	JSON-LD schema.org: Product, Article, Organization, Breadcrumb, FAQ — validation
seo-meta	Title/description generation: lengths, uniqueness, CTR, Open Graph, Twitter Cards

Script

python3 scripts/seo_schema.py --meta file.html      # title/desc/OG/canonical/h1/img audit
python3 scripts/seo_schema.py --jsonld file.html    # extract + validate JSON-LD blocks

• --meta: title + length, description, canonical, og:title/description/image, twitter:card, robots, heading order, missing img alt.
• --jsonld: extracts application/ld+json blocks and validates @context (schema.org), @type, and type-specific required fields (Product→offers+name, Article/BlogPosting→headline+author, FAQPage→mainEntity, Organization→name+url).
• Pure Python stdlib; stdin supported.

When to use

• User asks for “seo schema”, “json-ld”, “schema org”, “structured data”, “meta tags”, “разметка”, “структурированные данные”.
• A page needs its schema.org markup and meta layer checked or written.

Do NOT use

• For the full technical audit / CWV / reports / fixes — that is seo-audit.
• For content / keywords / headings / images — that is seo-content.
• For crawlability / linking structure — that is seo-crawl.

Boundaries

• Do not use for a full technical crawl or content rewrite; use seo-crawl or seo-content.

Markup workflow and output contract

Identify the page type and source-of-truth values before generating JSON-LD. Parse every block independently, validate JSON and required fields, check absolute URLs and ISO dates, then report the exact block or file location. Generated markup must be valid JSON, use only facts present in the project, and be previewed as a diff before applying.

Verification

Run the local script or a JSON parser after generation. Report validation errors separately from optional recommendations and distinguish schema.org validity from Google’s rich-result eligibility. Never promise a rich snippet or fabricate ratings, offers, authors, or dates.

This site is open source. View this page on GitHub.