CtrlK
BlogDocsLog inGet started
Tessl Logo

product

Use when auditing e-commerce product pages or implementing structured data for a shop. Applies to any page selling or describing a specific product.

60

Quality

70%

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/product/SKILL.md
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.

The body is a tight, well-structured overview with genuinely actionable field-level checks and correct progressive disclosure to a real references file. Its one clear weakness is redundancy: the Check, Code Review, and Explain sections overlap heavily, inflating token cost without adding guidance.

Suggestions

Merge 'Check' and 'Code Review' into a single verification section — they repeat the same find-blocks/verify-fields/match-price/run-Rich-Results-Test steps with only format details differing.

Fold the 'Explain' section into the intro paragraph; both make the same rich-result/CTR argument, so one mention suffices.

Move the field format constraints that only appear in 'Code Review' (absolute URL array, numeric price, ISO 4217, schema.org availability URL) up into the 'Fix' required/recommended field lists so one section carries the full spec.

DimensionReasoningScore

Conciseness

The body is short, but 'Check' and 'Code Review' largely duplicate each other (both: 'Find/Check JSON-LD blocks with @type Product', 'verify required fields', 'price matches visible page', 'Validate with Google's Rich Results Test'), and 'Explain' repeats the intro's rich-result/CTR claim. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened') rather than 2, since the padding is duplicated sections, not explanation of concepts Claude doesn't know.

3 / 5

Actionability

The guidance is concrete and executable without code: exact required fields with format constraints ('offers.price (numeric)', 'ISO 4217 code', 'schema.org URL', 'absolute URL array'), a named validation tool ('Google's Rich Results Test'), and a price-match invariant. It fits anchor 4 ('Mostly executable guidance... minor gaps') rather than 5 because the body itself contains no copy-paste JSON-LD example — the example lives only in references/rule.md, which per the rubric's scoring notes is not penalized further for an instruction-oriented skill.

4 / 5

Workflow Clarity

The Check → Fix → Code Review structure forms a clear single-purpose sequence with explicit checkpoints ('Check that prices in schema match the visible page prices', 'Validate with Google's Rich Results Test', 'reviewCount > 0 if rating is present'), fitting anchor 4. It is not 5 because there is no error-recovery loop (what to do when the Rich Results Test fails is only implied by the Fix section), and the validation steps are spread across three near-duplicate sections instead of one ordered checklist.

4 / 5

Progressive Disclosure

The body is a lean overview under 50 lines, well-sectioned (Quick Reference, Check, Fix, Explain, Code Review), with a clearly signaled one-level-deep pointer that matches the real bundle: 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' (file exists; no nested references inside it). This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split').

5 / 5

Total

16

/

20

Passed

Description

70%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 an explicit and well-formed 'Use when...' trigger with natural domain terms, and it is appropriately concise in third person. Its main weaknesses are the absence of the skill's concrete artifacts (Product schema, JSON-LD, rich results) as trigger terms and an action list that stays at two generic verbs.

Suggestions

Name the concrete deliverable in the what-clause, e.g. 'Adds and validates Product JSON-LD structured data on e-commerce product pages', to raise specificity.

Add missing natural trigger terms users would say: 'Product schema', 'JSON-LD', 'rich results', 'rich snippets', 'Google Shopping'.

Differentiate from sibling structured-data rules by scoping triggers to product/shop pages specifically (e.g. 'product detail pages, PDPs, product listings') rather than the generic 'any page selling or describing a product'.

DimensionReasoningScore

Specificity

The description names the domain ("e-commerce product pages", "structured data for a shop") and two actions ("auditing", "implementing structured data"), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It stops short of anchor 4 because it never lists several specific actions (no mention of JSON-LD, Product schema, rich result validation, or price-matching checks).

3 / 5

Completeness

The 'when' is explicit and repeated ("Use when auditing e-commerce product pages or implementing structured data for a shop. Applies to any page selling or describing a specific product."), and a 'what' is present (audit/implement structured data on product pages). It fits anchor 4 rather than 5 because the 'what' could be more concrete — it never says the skill adds or validates Product schema/JSON-LD markup.

4 / 5

Trigger Term Quality

Natural phrases like "e-commerce product pages", "structured data", "shop", and "any page selling or describing a specific product" give good keyword coverage, fitting anchor 4 ('Good keyword coverage; a few natural terms missing'). It is not anchor 5 because common variations users would say — "Product schema", "JSON-LD", "rich results/rich snippets" — are absent.

4 / 5

Distinctiveness Conflict Risk

The niche (product-page structured data) is mostly distinct with clear product/shop triggers, matching anchor 4 ('Mostly distinct; minor overlap risk with closely related skills'). It is not anchor 5 because sibling SEO structured-data skills (e.g., a generic JSON-LD or schema-markup rule) could plausibly trigger on the same phrasing.

4 / 5

Total

15

/

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.