CtrlK
BlogDocsLog inGet started
Tessl Logo

definition-list

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Use correct definition list structure. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

60

Quality

71%

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/definition-list/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 concise, well-structured overview that correctly pushes detail to a real one-level-deep reference file. Its weakest point is actionability: the fix guidance is vague, and the body's advice about <div> wrappers contradicts the reference file (which shows div-wrapped dt/dd pairs as valid HTML5), which could lead to a wrong fix.

Suggestions

Resolve the <div> contradiction: the Quick Reference says to avoid div wrappers, but references/rule.md explicitly shows div-wrapped dt/dd pairs as valid HTML5 — align the body with the reference.

Inline one minimal good/bad <dl> markup example so the Check and Fix steps are immediately executable without opening the reference.

Replace 'wrap them appropriately to maintain semantic integrity' with the concrete fix pattern: move non-dt/dd content outside the <dl>, or wrap dt/dd pairs in a <div> for styling.

DimensionReasoningScore

Conciseness

The body is lean (~40 lines), well-sectioned, and does not re-explain concepts Claude already knows; nearly every line carries instruction. It is not a 5 because the 'Explain' section directs Claude to do something it already knows how to do, and the 'Code Review' section repeats the rule title mid-sentence ('that affect Use correct definition list structure'), adding template noise.

4 / 5

Actionability

There is concrete guidance — 'Ensure <dl> contains only <dt>, <dd>, or <script>/<template> tags' names specific tags — but key details are missing or misleading: the Quick Reference says 'Avoid wrapping list items in invalid container elements like <div>' while references/rule.md and HTML5 explicitly allow div wrappers around dt/dd pairs, and the fix instruction 'wrap them appropriately to maintain semantic integrity' is vague with no inline good/bad markup example. This fits 'some concrete guidance but incomplete / missing key details' rather than 4.

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sequence is clearly ordered for a simple single-purpose skill, and verification is mentioned ('note how to verify the fix with browser accessibility tooling or assistive tech'). Not a 5 because the validation checkpoint is only implied in the body — actual verification steps are delegated to references/rule.md rather than stated inline.

4 / 5

Progressive Disclosure

The body is a concise overview with clear sections and a single, well-signaled, one-level-deep reference — 'For full implementation details, code examples, and framework-specific guidance, see references/rule.md' — and that file exists and matches its advertised purpose. For a short skill with one appropriate bundle file, structure and navigation are clean.

5 / 5

Total

16

/

20

Passed

Description

71%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 is a serviceable templated accessibility-review description with an explicit 'Use when' clause, concrete inspection actions, and relevant trigger vocabulary. Its main weaknesses are the awkward mid-sentence embedding of the rule title, generic when-phrasing shared across a rule family, and missing natural synonyms like 'dl'/'description list'.

Suggestions

Rewrite the templated phrase 'related to Use correct definition list structure' into natural trigger phrasing, e.g. 'Use when auditing HTML definition lists (<dl>, <dt>, <dd>) or markup where terms and descriptions must be associated.'

Add natural synonyms users would say — 'dl element', 'description list', 'dt/dd', 'a11y markup' — to improve trigger coverage and distinctiveness from sibling accessibility rules.

Narrow the when-clause beyond the shared 'rendered HTML, interactive components, or design-system patterns' template so this skill is distinguishable from other accessibility rules using the same boilerplate.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output' — naming specific review activities rather than vague capability claims. It falls short of a 5 because coverage has gaps (no mention of producing fixes/reports) and the actions are generic accessibility-review boilerplate rather than definition-list-specific.

4 / 5

Completeness

Both parts are explicitly present: 'what' via 'Check native semantics first, then inspect keyboard behavior...' and 'when' via the explicit 'Use when reviewing rendered HTML, interactive components, or design-system patterns' clause. It is not a 5 because the when-clause is broad and templated — it would fit nearly any accessibility rule — rather than a crisp, concrete trigger tied to definition lists.

4 / 5

Trigger Term Quality

Natural trigger terms are present: 'rendered HTML', 'interactive components', 'definition list structure', 'keyboard behavior', 'focus flow', 'accessible names', 'screen-reader output' — phrases a user raising this issue would plausibly say. Not a 5 because common synonyms and element names are missing ('dl', 'dt', 'dd', 'description list', 'a11y'), and the awkward embedded phrase 'related to Use correct definition list structure' is a rule title, not natural user phrasing.

4 / 5

Distinctiveness Conflict Risk

The only distinguishing element is the embedded rule title 'Use correct definition list structure'; the surrounding trigger ('reviewing rendered HTML, interactive components, or design-system patterns') is a shared template that would fire identically for any sibling accessibility rule in this family. This matches 'somewhat specific but could still overlap with similar skills' — not a 4, since the overlap with closely related accessibility skills is more than minor.

3 / 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.