CtrlK
BlogDocsLog inGet started
Tessl Logo

sensory-instructions

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

58

Quality

68%

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/sensory-instructions/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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-disclosed, compact overview that correctly delegates implementation detail to a real, appropriately scoped reference file. Its weaknesses are repetition (the same rationale appears three times, and the Explain section re-teaches known concepts), a muddled section order that breaks workflow flow, and vague verification guidance.

Suggestions

Remove the redundant rationale: it appears in the intro, as parenthetical examples in Check, and again in Explain — keep it once and delete the Explain section, which re-teaches accessibility concepts Claude already knows.

Reorder sections into a coherent review workflow (e.g., Check -> Fix -> Verify with a specific tool such as axe DevTools or a screen-reader pass), and make the verification step explicit rather than 'browser accessibility tooling or assistive tech'.

Move the Code Review workflow earlier and fold the Check list into it so the primary procedure isn't deferred to the last section after non-procedural Explain content.

DimensionReasoningScore

Conciseness

The rationale sentence ('Color-blind users can't see click the red button, screen reader users can't perceive the menu on the right, and deaf users miss audio cues') is repeated nearly verbatim in the intro, again as parenthetical examples in Check, and re-explained in Explain — the latter section teaches concepts Claude already knows. Mostly efficient, but the systematic duplication keeps it below anchor 4.

3 / 5

Actionability

Provides concrete, executable guidance for an instruction-only skill: an explicit list of patterns to flag ('click the red button', 'the circular icon', 'the menu on the right', 'when you hear the beep') and a concrete before/after fix ('Instead of click the green button, use click the Submit button (green)'). Not 5 because verification guidance is vague ('browser accessibility tooling or assistive tech') with no specific tool or check, and the body has no example markup (that lives in the reference).

4 / 5

Workflow Clarity

Sections exist (Check, Fix, Explain, Code Review) but the sequence is incoherent: 'Explain' is not a workflow step and sits mid-flow, while the actual review workflow (Code Review) appears last after Fix. Verification is mentioned only implicitly ('verify the fix with browser accessibility tooling'), matching the anchor 'sequence present but checkpoints missing or implicit' rather than 4's mostly-present checkpoints.

3 / 5

Progressive Disclosure

The short SKILL.md body is a clean overview with a clearly signaled, one-level-deep pointer to references/rule.md ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'), and that file exists (199 lines) with the promised code examples and detail. Content is appropriately split and easy to navigate, matching the simple-skill exception in the scoring notes.

5 / 5

Total

15

/

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 has both an explicit 'Use when...' trigger and several concrete review actions, making it functional and reasonably specific. Its main weaknesses are awkward phrasing around the actual rule name and a large amount of generic accessibility-review language that raises conflict risk with sibling accessibility skills.

Suggestions

Lead with the rule-specific capability, e.g., 'Flag and fix instructions that rely solely on color, shape, location, or sound (e.g., click the red button, the menu on the right) by adding text labels and multi-modal cues', so the distinguishing trigger comes first instead of generic review-process language.

Replace the awkward clause 'related to Avoid sensory-only instructions' with natural trigger phrases such as 'accessibility review', 'a11y', or 'WCAG' to improve trigger-term coverage and distinctiveness.

Trim the shared generic checklist ('keyboard behavior, focus flow, accessible names, screen-reader output') down to what is specific to sensory-only instructions to reduce overlap with sibling accessibility skills.

DimensionReasoningScore

Specificity

Lists several concrete review actions ('Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output') grounded in a named domain (rendered HTML, interactive components, design-system patterns). Falls short of 5 because coverage of what the skill does is process-oriented and incomplete rather than comprehensive.

4 / 5

Completeness

Both 'what' (check semantics, inspect keyboard behavior, focus flow, accessible names, screen-reader output) and 'when' ('Use when reviewing rendered HTML, interactive components, or design-system patterns related to...') are explicitly present. Not 5 because the hedge 'where relevant' and the awkward clause 'related to Avoid sensory-only instructions' make the what/when less crisp and concrete than the anchor-5 example.

4 / 5

Trigger Term Quality

Includes natural terms a user would plausibly say: 'rendered HTML', 'interactive components', 'design-system patterns', 'keyboard behavior', 'screen-reader output'. A few common natural variations are missing (e.g., 'accessibility', 'a11y', 'screen reader review', 'WCAG'), which keeps it below the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

Only the buried phrase 'Avoid sensory-only instructions' distinguishes this skill; the rest ('Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output') is generic accessibility-review language shared by many sibling a11y rules, so it could still overlap with closely related skills. Not 4 because the distinguishing trigger is not the lead element and the overlap with other accessibility-checklist skills is real.

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.