CtrlK
BlogDocsLog inGet started
Tessl Logo

image-redundant-alt

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

58

Quality

67%

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/image-redundant-alt/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 well structured and token-efficient, with a textbook progressive-disclosure split: a lean SKILL.md pointing to a single reference that holds the code examples and verification steps. The weakest area is actionability — the body directs but never shows, deferring all concrete examples (before/after alt text, checker commands) to the reference file.

Suggestions

Inline one minimal before/after pair in the Fix section (e.g. `alt="A photo of a dog"` → `alt="dog"`) so the core fix is executable without opening the reference.

Add a concrete verification command in the body (e.g. run axe or Lighthouse and inspect the accessibility tree for the accessible name) so the check→fix→verify loop is self-contained.

Merge or differentiate the 'Check' and 'Code Review' sections, which currently restate the same scan-and-flag guidance, and trim the intro sentence explaining screen-reader verbosity that Claude already knows.

DimensionReasoningScore

Conciseness

The body is short (~30 lines) and mostly lean, with each section earning its place (Quick Reference rules, Check patterns, Fix direction). It is a 4 rather than 5 because of minor over-explanation that could be trimmed: the intro sentence and the 'Explain' section re-teach why screen-reader redundancy is bad — knowledge Claude already has — and the 'Code Review' paragraph largely restates the description boilerplate.

4 / 5

Actionability

The Check section gives concrete scan patterns ("redundant phrases like 'image of', 'photo of', or text that duplicates surrounding content") and the Fix section states the remedy, but the body contains no example markup, selector, command, or before/after alt-text pair — those concrete artifacts live only in references/rule.md. This matches 'some concrete guidance but incomplete; missing key details' rather than 4, which requires mostly executable guidance in the body itself.

3 / 5

Workflow Clarity

For this simple single-purpose skill the sequence is clear and unambiguous: Quick Reference → Check → Fix → Explain, with verification steps available in the reference file. It does not reach 5 because the body itself includes no verification checkpoint (verification is deferred entirely to references/rule.md) and the 'Code Review' section overlaps with 'Check', creating mild redundancy rather than a crisp single flow.

4 / 5

Progressive Disclosure

The body is a concise overview with a clearly signaled, one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file exists and delivers exactly what is promised (incorrect/correct code examples, best practices, verification) without further nesting. This matches the 'clear overview with well-signaled one-level-deep references; easy navigation' anchor.

5 / 5

Total

16

/

20

Passed

Description

63%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 uses proper third-person imperative voice and has an explicit 'Use when' trigger with several concrete inspection actions. Its main weaknesses are the absence of the natural trigger term 'alt text', a generic trigger clause that risks conflicts with sibling accessibility skills, and a missing statement of the skill's core action (fix redundant alt text).

Suggestions

Include the natural trigger terms users actually say — e.g. "Use when reviewing alt text, image alt attributes, or accessible images in rendered HTML" — since 'alt text' is the phrase most likely to be typed.

State the core capability as a concrete action rather than relying on the embedded rule name, e.g. "Flags and fixes redundant image alt text (e.g. 'image of', 'photo of', alt duplicating adjacent text)".

Narrow the broad trigger clause ("interactive components, or design-system patterns") to image/alt-text-specific contexts so the description does not fire for unrelated accessibility reviews where sibling rules apply.

DimensionReasoningScore

Specificity

Quotes like "Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output" list several concrete inspection actions, matching the 'several specific actions; minor gaps in coverage' anchor. It is not a 5 because the core capability of the rule — identifying and fixing redundant alt text — is never stated as an action, and it is not a 3 because more than 1-2 concrete actions are explicitly named.

4 / 5

Completeness

Both halves are explicit: 'when' via "Use when reviewing rendered HTML, interactive components, or design-system patterns related to Avoid redundant image alternative text" and 'what' via the listed check/inspect actions. It falls short of the 5 anchor because the 'what' describes generic accessibility inspection rather than concretely stating what the skill does about redundant alt text, leaving the primary action implied by the rule name.

4 / 5

Trigger Term Quality

Relevant keywords are present ("reviewing rendered HTML, interactive components", "screen-reader", "image alternative text") but the natural phrase users would actually say — "alt text" or "alt attribute" — never appears, and no synonyms/extensions are covered. This fits 'some relevant keywords but missing common variations or synonyms' rather than 4, where only a few natural terms would be missing — here the single most important trigger term is absent.

3 / 5

Distinctiveness Conflict Risk

The rule topic is specific, but the broad trigger clause "reviewing rendered HTML, interactive components, or design-system patterns" is generic accessibility-review boilerplate that would fire equally for any sibling a11y rule skill, so overlap with closely related skills is real. It is not 4 because the only distinguishing content is the embedded rule name, and not 2 because the alt-text topic does provide some narrowing.

3 / 5

Total

14

/

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.