CtrlK
BlogDocsLog inGet started
Tessl Logo

fixing-accessibility

Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, focus management, color contrast, and form errors. Use when adding interactive controls, forms, dialogs, or reviewing WCAG compliance.

91

1.06x
Quality

86%

Does it follow best practices?

Impact

99%

1.06x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%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-organized, lean checklist-style skill with concrete before/after code examples, clear priorities, and an explicit review workflow. Its minor gaps are placeholder-laden fix examples, some rules that restate widely known WCAG basics, and a rule catalog that could be offloaded to a reference file as the skill grows.

Suggestions

Make the 'common fixes' examples fully copy-paste ready by replacing the '<svg>...</svg>' ellipses with minimal complete elements.

Trim quick-reference rules that restate knowledge Claude already has (e.g., 'links must have meaningful text') down to only the non-obvious constraints, or move the full 9-category rule catalog into a references/ file and keep a short priority summary in SKILL.md.

Name one or two established accessible primitives (e.g., specific dialog/menu libraries or ARIA Authoring Practices patterns) so the 'prefer established primitives' guidance is executable.

DimensionReasoningScore

Conciseness

The body is a lean rule catalog: terse directives ("modals must trap focus while open", "do not use tabindex greater than 0") and compact before/after snippets with no filler or concept explanations, so it is well above anchor 3. It is not a 5 because a portion of the quick-reference rules restate standard WCAG knowledge Claude already has (e.g., "links must have meaningful text", "images must have correct alt text"), which could be trimmed without loss.

4 / 5

Actionability

Concrete, code-level guidance is present: a priority table, exact attributes to apply (aria-describedby, aria-invalid, aria-expanded), and executable before/after HTML in the "common fixes" block, plus an explicit review output format (quote the snippet, state the failure, propose a small fix). Not a 5 because the fix examples use ellipsis placeholders ("<svg>...</svg>") rather than fully copy-paste-ready code, and complex-widget guidance defers to "established accessible primitives" without naming any.

4 / 5

Workflow Clarity

As a simple single-purpose instruction skill, both usage modes are unambiguous: constraint mode ("Apply these constraints to any UI work") and file-review mode with an explicit report structure (violations with quoted lines, why it matters, a concrete fix) plus priority ordering ("fix critical issues first (names, keyboard, focus, tool boundaries)") and a scoped-change rule ("Do not rewrite large parts of the UI"). No destructive or batch operations exist, so no validation checkpoints are required; the single action is unambiguous, meeting the simple-skill exception.

5 / 5

Progressive Disclosure

Structure is good: a priority table up front, nine clearly headed rule categories ordered by priority, a common-fixes example block, and a closing review-guidance section, with no external bundle files present or needed. Not a 5 because the body exceeds the under-50-lines simple-skill threshold, and the nine-category rule catalog (~90 lines of rules) could arguably be split into a reference file to keep SKILL.md a leaner overview; still clearly above anchor 3 since everything present is well-signaled and navigable.

4 / 5

Total

17

/

20

Passed

Description

92%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 strong anchor-5 style example: explicit third-person capability statement plus a concrete 'Use when...' clause with natural trigger terms. The only minor gap is absence of common synonyms like 'a11y' and 'screen readers' that some users would naturally say.

DimensionReasoningScore

Specificity

"Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, focus management, color contrast, and form errors" lists multiple specific concrete actions (audit, fix) with comprehensive enumeration of the domain's capability areas (ARIA, keyboard, focus, contrast, form errors), matching the anchor-5 example's coverage pattern. It is not a 4 because coverage is comprehensive rather than having minor gaps, and not below since every named capability is concrete rather than generic.

5 / 5

Completeness

The "what" is explicit ("Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, focus management, color contrast, and form errors") and the "when" is explicit with concrete trigger phrases ("Use when adding interactive controls, forms, dialogs, or reviewing WCAG compliance"), directly matching the anchor-5 example structure. Not a 4 because the when-clause is specific and trigger-phrased rather than merely adequate.

5 / 5

Trigger Term Quality

Natural user phrases like "ARIA labels", "keyboard navigation", "color contrast", "dialogs", "forms", and "WCAG compliance" give good keyword coverage across the domain. A few natural terms users commonly say are missing (e.g., "a11y", "screen readers"), which fits anchor 4 rather than the comprehensive synonym coverage of anchor 5; it is clearly above anchor 3 because most common phrasings are present.

4 / 5

Distinctiveness Conflict Risk

Accessibility auditing/fixing is a clear niche with distinct triggers (ARIA, WCAG, keyboard navigation, focus management) that virtually no other skill would claim, matching "clear niche with distinct triggers; minimal conflict risk". Not a 4 because overlap with related skills (e.g., general frontend work) is negligible given the WCAG/ARIA-specific trigger vocabulary.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ibelick/ui-skills
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.