CtrlK
BlogDocsLog inGet started
Tessl Logo

structured-data

Use when auditing metadata, crawlability, structured data, or indexability related to Add structured data markup. Verify the rendered HTML and HTTP response rather than relying only on source files.

52

Quality

57%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/structured-data/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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.

The body is a well-structured, appropriately lean overview that correctly delegates implementation detail to references/rule.md, and the reference file is real and substantive. Weaknesses are the near-duplicate rich-snippets sentence and the Fix section's abstract guidance with no in-body example or explicit validation checkpoint.

Suggestions

Remove the duplicated rich-snippets sentence — keep it in either the intro or Quick Reference, not both.

Add a minimal in-body JSON-LD snippet plus the validation step as an ordered checkpoint ('After adding markup, validate with Google Rich Results Test; fix errors and re-validate'), or fold it into a numbered Check → Fix → Validate workflow.

Make the Fix section concrete by listing the content-type-to-schema mapping (Article, Product, FAQ, HowTo, LocalBusiness) it already names in Quick Reference, rather than 'appropriate... structured data based on its content type'.

DimensionReasoningScore

Conciseness

The body is short and sectioned, but there is clear redundancy: the opening line 'Structured data enables rich snippets with stars, prices, images, and FAQ dropdowns in search results—significantly increasing click-through rates' is repeated nearly verbatim as the first Quick Reference bullet, and the 'Explain' section re-states the same idea. It matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not 4 because the duplication is a visible trim candidate, not a minor one.

3 / 5

Actionability

'Check for JSON-LD, Microdata, or RDFa markup' and 'Validate with Google Rich Results Test' name concrete tools/formats, but the Fix section is abstract ('Add appropriate Schema.org structured data... based on its content type') with no example markup or commands in the body — the executable JSON-LD example lives only in references/rule.md. This matches 'Some concrete guidance but incomplete; missing key details'.

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections give a recognizable sequence, and 'Validate with Google Rich Results Test' hints at verification, but no explicit validation checkpoint (e.g. 'validate after adding markup') or error-recovery loop appears in the body. This matches 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'; not 4 because the validation step is a bullet in Quick Reference rather than an ordered checkpoint.

3 / 5

Progressive Disclosure

The body is a concise overview with clear sections, and detailed material is pushed to a single, real, one-level-deep reference ('see references/rule.md', verified to exist and contain the implementation details and code example), clearly signaled at the end. This matches the 'Clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

14

/

20

Passed

Description

57%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.

The description has a clear 'Use when' trigger clause with decent natural SEO keywords and one distinctive verification instruction, but it never states what the skill concretely does — the capability is delegated to the rule title 'Add structured data markup'. It is serviceable but sits at the midpoint of the rubric.

Suggestions

State the capability explicitly in third person, e.g. 'Checks rendered HTML for Schema.org structured data (JSON-LD, Microdata, RDFa), adds markup for the page's content type, and explains rich-snippet benefits.'

Include the missing natural trigger terms users say: 'schema.org', 'JSON-LD', 'rich snippets', 'rich results', 'Google Rich Results Test'.

Narrow the broad triggers ('metadata', 'crawlability', 'indexability') to structured-data-specific contexts to reduce overlap with sibling SEO skills.

DimensionReasoningScore

Specificity

The description names the SEO/structured-data domain and one concrete action ('Verify the rendered HTML and HTTP response rather than relying only on source files') but the core capability is only implied through the phrase 'related to Add structured data markup', which reads as a rule title rather than an action. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; a 4 would require several specific listed actions, which the text does not provide.

3 / 5

Completeness

The 'when' is explicit ('Use when auditing metadata, crawlability, structured data, or indexability'), but the 'what' is weak: the only forward-looking capability stated is 'Verify the rendered HTML and HTTP response', and 'related to Add structured data markup' does not state what the skill actually does (check/fix/explain structured data). It sits between the 'only when present without what' (2) and 'both present, when could be more specific' (4) anchors, closer to the midpoint but not clearly at 4.

3 / 5

Trigger Term Quality

'auditing metadata, crawlability, structured data, or indexability' gives good natural-keyword coverage of terms an SEO-minded user would say, comparable to the 'PDF files, forms, document extraction' anchor. It misses common variations like 'schema.org', 'JSON-LD', 'rich snippets', or 'rich results', so it does not reach the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'structured data' is a distinctive niche term, but 'auditing metadata, crawlability, or indexability' is broad SEO territory that would also naturally trigger sibling SEO audit skills (meta-tag rules, crawlability rules), matching 'Somewhat specific but could still overlap with similar skills'. It does not reach 4 because the trigger set is not narrowly scoped to structured data.

3 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.