schema-markup

When the user wants to implement, audit, or validate structured data (schema markup) on their website. Use when the user mentions 'structured data,' 'schema.org,' 'JSON-LD,' 'rich results,' 'rich snippets,' 'schema markup,' 'FAQ schema,' 'Product schema,' 'HowTo schema,' or 'structured data errors in Search Console.' Also use when someone asks why their content isn't showing rich results or wants to improve AI search visibility. NOT for general SEO audits (use seo-audit) or technical SEO crawl issues (use site-architecture).

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body that delegates copy-paste patterns to verified one-level-deep references and supplies concrete commands, URLs, and a selection table. The main improvement opportunity is folding validation checkpoints directly into each workflow mode rather than only in a separate Testing section.

Suggestions

Embed an explicit 'Validate before delivering' step inside Mode 2 (e.g. run schema_validator.py / rich-results test before step 5) so the implementation workflow has an inline checkpoint rather than relying on a separate section.

Trim the justificatory prose in 'JSON-LD vs Microdata vs RDFa' and the 'Schema and AI Search' rationale to one-liners; the tables and action lists already carry the value.

Add a brief inline Article or FAQPage JSON-LD example (5-8 lines) in the body so a single page type is fully demonstrable without opening the reference file.

Dimension	Reasoning	Score
Conciseness	Largely lean and actionable — tables, numbered steps, and a code block earn their place — with only minor over-explanation (e.g. justifying JSON-LD over microdata, the AI-search rationale prose); matches 'efficient; minor instances of over-explanation that could be trimmed' rather than the fully lean 5.	4 / 5
Actionability	Provides fully executable guidance: a runnable command (`python3 scripts/schema_validator.py page.html`), real validator URLs, a copy-paste placement code block, a concrete schema-selection table, and CMS-specific instructions, matching the 'fully executable; copy-paste ready' anchor.	5 / 5
Workflow Clarity	Three clearly sequenced numbered workflows (audit, implement, validate-and-fix) plus a dedicated Testing & Validation section, but validation checkpoints are not embedded within each mode (e.g. Mode 2 delivers JSON-LD without an inline 'validate before delivering' step), matching 'clear sequence with most checkpoints present; minor validation gaps.'	4 / 5
Progressive Disclosure	Clear overview body that signals one-level-deep references (`references/implementation-patterns.md`, `references/schema-types-guide.md`) and a script (`scripts/schema_validator.py`), all of which exist and do not nest further; content is appropriately split with easy navigation, matching the top anchor.	5 / 5
	Total	18 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-targeted description that crisply states what the skill does, lists natural trigger terms comprehensively, and carves out a clear niche with explicit negative boundaries against sibling skills. Voice is appropriately third-person ('the user,' 'someone') with no first/second-person penalty.

Dimension	Reasoning	Score
Specificity	Names the domain plus three concrete actions — 'implement, audit, or validate structured data' — matching the 'lists several specific actions; minor gaps' anchor; not a 5 because coverage is limited to those three verbs without enumerating sub-tasks.	4 / 5
Completeness	Explicitly answers both what (implement/audit/validate structured data) and when ('Use when the user mentions... Also use when someone asks why their content isn't showing rich results or wants to improve AI search visibility'), with concrete trigger phrases matching the top anchor.	5 / 5
Trigger Term Quality	Comprehensive natural-term coverage including synonyms and specific phrasings users say: 'structured data,' 'schema.org,' 'JSON-LD,' 'rich results,' 'rich snippets,' 'schema markup,' 'FAQ schema,' 'Product schema,' 'HowTo schema,' plus 'structured data errors in Search Console,' matching the top anchor.	5 / 5
Distinctiveness Conflict Risk	Clear niche (schema markup) with distinct triggers and an explicit negative boundary ('NOT for general SEO audits (use seo-audit) or technical SEO crawl issues (use site-architecture)') minimizing conflict risk, matching the top anchor.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: alirezarezvani/claude-skills
Path: marketing-skill/skills/schema-markup/SKILL.md
Commit: 19392f7

Reviewed: ~2 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.