sergekostenchuk/seo-llm-skill-cluster / skills/technical-seo-schema-engineer
technical-seo-schema-engineer
VerifiedDesign deterministic technical SEO and schema.org guidance for crawlable public pages. Use this skill when the user asks for title and meta description rules, canonical and hreflang tags, JSON-LD schema, NewsArticle, Article, TechArticle, BreadcrumbList, WebSite, Organization, Person, OpenGraph, Twitter cards, sitemap, news-sitemap, RSS, robots.txt, llms.txt, publisher logo, ImageObject, or metadata templates that must match visible content.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.1 KB |
| agents/openai.yaml | config | 419 B |
| assets/head-metadata.template.html | other | 1.5 KB |
| assets/jsonld-templates.md | markdown | 2.9 KB |
| evals.json | config | 1.9 KB |
| references/schema-patterns.md | markdown | 3.1 KB |
| validation-report.md | markdown | 1.4 KB |
references/schema-patterns.md
View on GitHub# Schema And Metadata Patterns
## Principle
Metadata and schema describe the visible page. They do not create a second hidden version of the page for crawlers or LLM agents.
## Page Type Matrix
| Page Type | Head Metadata | JSON-LD |
| --- | --- | --- |
| `home` | title, description, canonical, hreflang, OG/Twitter, RSS autodiscovery | `WebSite`, `Organization`, `Person`, `CollectionPage` or `WebPage` |
| `news_index` | title, description, canonical, hreflang, OG/Twitter, RSS | `CollectionPage`, `BreadcrumbList` |
| `news_brief` | title, description, canonical, hreflang, OG/Twitter, article meta | `NewsArticle`, `BreadcrumbList` |
| `longform_article` | title, description, canonical, hreflang, OG/Twitter, article meta | `TechArticle` or `Article`, `BreadcrumbList` |
| `topic` | title, description, canonical, hreflang, OG/Twitter | `CollectionPage`, `DefinedTerm`, `BreadcrumbList` |
| `project` | title, description, canonical, hreflang, OG/Twitter | `SoftwareApplication` or `CreativeWork`, `BreadcrumbList` |
| `blog` | title, description, canonical, hreflang, OG/Twitter, article meta | `BlogPosting` or `Article`, `BreadcrumbList` |
| `author` | title, description, canonical, hreflang, OG/Twitter | `Person`, `ProfilePage`, `BreadcrumbList` |
## Required Visible Fields
For article-like pages:
- headline;
- description or dek;
- author;
- date published;
- date modified when available;
- language;
- image or fallback image;
- canonical URL;
- publisher.
For topic/project/author pages:
- visible name;
- description;
- canonical URL;
- relationship to the site;
- visible supporting links when schema references related pages.
## ImageObject Policy
Use this fallback order:
1. verified article media image;
2. verified video poster;
3. page-specific generated OG card;
4. stable site fallback OG card.
Never leave `NewsArticle.image` empty when a fallback can be defined.
## Canonical And Hreflang
- Canonical follows `url-map.yaml`.
- Each indexable localized page self-canonicalizes.
- Hreflang connects true equivalents only.
- `x-default` points to the default page or language selector.
- Brief and longform can both be self-canonical when page roles differ.
## FAQ And HowTo Rules
FAQPage and HowTo schema are allowed only when the relevant blocks are visible to users on the page.
Do not create hidden FAQ schema for SEO.
## Robots, Sitemap, RSS, llms.txt
- `robots.txt` should allow public value pages and block admin/API/private surfaces.
- XML sitemap contains canonical public URLs only.
- News sitemap contains eligible recent news URLs only.
- RSS exposes public feed items and should be linked in `<head>`.
- `llms.txt` links only to public useful canonical pages and must not include secrets, drafts, admin URLs, or private APIs.
## Validation Handoff
The regression validator should verify:
- title exists and is unique enough;
- meta description exists;
- canonical exists and is expected;
- hreflang alternates match URL map;
- JSON-LD parses;
- required schema fields exist;
- schema fields match visible content;
- OG/Twitter cards exist;
- image URLs return usable assets;
- sitemap/RSS/robots/llms.txt are reachable when live.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |