CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

schema

When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," or "add structured data." Use this whenever someone wants their pages to show enhanced results in Google. For broader SEO issues, see seo-audit. For AI search optimization, see ai-seo.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%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, current skill whose standout strength is the Google feature-support guidance (retirement dates with citations and a pre-implementation eligibility gate) plus clean progressive disclosure to a real examples file. The main costs are token redundancy — the Quick Reference repeats the types table and Core Principles states the obvious — and placeholder JSON-LD blocks instead of one complete inline example.

Suggestions

Merge the 'Common Schema Types' table and the 'Quick Reference' section into a single table with both Required and Recommended columns; the Required entries are currently duplicated verbatim across the two sections (~20 lines saved).

Cut or compress the 'Core Principles' section, which restates knowledge Claude already has ('Test before deploying,' 'Don't markup content that doesn't exist,' 'Google recommends JSON-LD'); keep only the non-obvious rules such as the retired-feature handling.

Replace the placeholder JSON-LD blocks ('"@type": "...", // Complete markup' and the '@graph' skeleton) with one small complete inline example (e.g., a full BreadcrumbList) and point to the specific section of references/schema-examples.md for the rest.

DimensionReasoningScore

Conciseness

Mostly efficient — tables, tight bullets, and a genuinely valuable non-obvious feature-support section (FAQ rich results retired May 7, 2026; HowTo retired Sept 2023; sitelinks search box retired Nov 2024, each with official links) that is appropriately isolated rather than scattered. But there is more than minor padding: the 'Quick Reference' section's 'Required' lines duplicate the 'Common Schema Types' table verbatim (Organization 'name, url'; Product 'name, image, offers'; FAQPage 'mainEntity'; BreadcrumbList 'itemListElement'), and the 'Core Principles' section restates knowledge Claude already has ('Test before deploying,' 'Don't markup content that doesn't exist,' 'Google recommends JSON-LD format'). This fits the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor better than the level-4 'minor instances' anchor.

3 / 5

Actionability

Guidance is largely concrete and executable: exact required/recommended property lists, a real validation toolset with URLs (Rich Results Test, validator.schema.org, Search Console), specific error fixes ('Dates must be ISO 8601, URLs fully qualified, enumerations exact'), and complete JSON-LD examples one clearly signaled reference away (references/schema-examples.md, verified to contain full examples). It is not a 5 because the body's own code blocks are placeholders ('{"@type": "...", // Complete markup}' and the '@graph' skeleton with '...') rather than a single complete copy-paste-ready example inline.

4 / 5

Workflow Clarity

The sequence is clear — Initial Assessment (page type, current state, goals), the feature-support gate before implementation ('Check Google Feature Support First... do not recommend implementation to obtain a retired Google appearance'), implementation guidance per stack, then validation — and the closing Testing Checklist provides explicit checkpoints including a pre-flight 'Requested Google appearance is currently supported' item and post-hoc 'Validates in Schema.org Validator; supported Google features also pass Rich Results Test.' This is not schema/document manipulation or a batch/destructive operation, so the validation cap does not apply; it falls short of 5 only because the flow is implied by section order rather than presented as one explicit numbered process with a fix-and-revalidate feedback loop.

4 / 5

Progressive Disclosure

The body is a genuine overview and the one bundle file is well signaled and exactly one level deep: 'For complete JSON-LD examples: See [references/schema-examples.md](references/schema-examples.md)' — a real file containing the complete per-type examples the body only sketches. Structure is easy to navigate (typed table, quick reference, validation, implementation, output format, checklist), matching the clear-overview/one-level-deep-references anchor.

5 / 5

Total

16

/

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 description: third-person, explicit what-and-when structure, an unusually thorough and natural trigger-term list, and explicit de-confliction pointers to sibling SEO skills. The only minor gap is that the action list (add/fix/optimize) could enumerate more of the skill's concrete capabilities such as validation or type selection.

DimensionReasoningScore

Specificity

Names the domain ('schema markup and structured data on their site') and several distinct concrete actions ('add, fix, or optimize'), matching the 'lists several specific actions; minor gaps in coverage' anchor. It falls short of a 5 because adjacent capabilities like validating markup or generating JSON-LD for specific page types are not named, and it is above a 3 because the three verbs are genuinely distinct operations rather than 1-2 generic actions.

4 / 5

Completeness

It explicitly answers both questions: what ('add, fix, or optimize schema markup and structured data on their site') and when ('Use this whenever someone wants their pages to show enhanced results in Google,' plus the enumerated trigger phrases). This matches the anchor for clearly and explicitly answering both what AND when with concrete trigger phrases; a 4 would require the 'when' to be less explicit, which is not the case here.

5 / 5

Trigger Term Quality

The quoted trigger list is comprehensive and natural: "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," and "add structured data." This covers synonyms, feature-specific variants, and the colloquial phrases a user would actually say (the 'rich snippets'/'star ratings in search' phrasings are especially natural), matching the comprehensive-coverage anchor exactly.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (structured data for rich results) with distinct triggers, and actively reduces overlap risk by routing adjacent requests elsewhere: 'For broader SEO issues, see seo-audit. For AI search optimization, see ai-seo.' This matches the clear-niche/minimal-conflict anchor; nothing in the description would plausibly fire for an unrelated skill.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

coreyhaines31/marketingskills

Path

skills/schema/SKILL.md

Reviewed

Table of Contents

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.