CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

84%

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

The canonical home for this skill is fixing-accessibility in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A tightly written constraint/review skill: lean checklist rules, concrete attribute-level directives, and copy-paste before/after fixes, with clear invocation modes and prioritized review order. Remaining gaps are small — some directional rules lack the specific attributes they demand, no dialog focus-trap example, and no post-fix verification step.

Suggestions

For "if a role is used, required aria attributes must be present", name the pairs (e.g., role=menu → aria-orientation/menuitem children) or add a micro-table so the rule is executable without external lookup.

Add a fourth common-fix example showing focus trapping and restoration for dialogs, since that is a critical-priority category with no code illustration.

Add a brief verification step to the review workflow (e.g., re-read the fixed snippet to confirm the name/keyboard issue is resolved and nothing else regressed) to close the feedback loop.

DimensionReasoningScore

Conciseness

The body is a lean, checklist-style rule set with no explanations of what accessibility is or why it matters beyond one short sentence per rule — it assumes Claude's competence throughout. Minor trimmable redundancy exists: the priority table's "impact" column duplicates the priority labels already shown in each section heading ("### 1. accessible names (critical)"), keeping it just below the every-token-earns-its-place 5 anchor.

4 / 5

Actionability

Rules are concrete directives with exact attribute names ("aria-describedby", "aria-invalid", "do not use tabindex greater than 0") and the "common fixes" section provides copy-paste-ready before/after HTML for three common cases. A few rules remain directional rather than executable — e.g., "if a role is used, required aria attributes must be present" never says which attributes, and there is no example for focus trapping in dialogs — so it sits below fully-executable 5.

4 / 5

Workflow Clarity

The invocation modes are explicit (apply constraints conversation-wide, or per-file review with a defined report format: quote snippet, why it matters, concrete fix), and "review guidance" sequences the work (fix critical categories first, prefer native elements, use established primitives for complex widgets). This is a review skill, not a destructive/batch operation, so no validation cap applies; the gap keeping it below 5 is the absence of any post-fix verification step (e.g., re-checking the fixed snippet or confirming no regression).

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and the body references no external paths, so scoring is against the single-file structure. Organization is good: numbered sections, a priority index table, a quick-reference hierarchy, and a common-fixes code block. The 5 anchor's well-signaled one-level-deep reference structure does not apply and the skill exceeds the under-50-lines simple-skill exception at ~137 lines, so this lands at 4 — well-structured, with the rule catalog being the kind of content that could optionally split into a reference file.

4 / 5

Total

16

/

20

Passed

Description

87%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.

A well-crafted description: concrete capability list plus an explicit 'Use when' clause with natural trigger terms. The only improvements are minor — adding a few more action verbs or common synonyms such as 'a11y' and 'screen reader'.

Suggestions

Add common synonyms such as 'a11y', 'screen reader compatibility', and 'alt text' to broaden natural trigger coverage.

Consider adding one more distinct action verb (e.g., 'report violations') alongside 'audit and fix' to enumerate the workflow more fully.

DimensionReasoningScore

Specificity

The description lists several specific capabilities — "Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, focus management, color contrast, and form errors" — with concrete objects for each. It stops short of the 5 anchor's multiple distinct action verbs (only "audit" and "fix") and omits a few areas like alt text and media, which is a minor gap in coverage.

4 / 5

Completeness

It clearly answers both questions: what it does ("Audit and fix HTML accessibility issues including...") and when to use it ("Use when adding interactive controls, forms, dialogs, or reviewing WCAG compliance"). The 'when' clause contains explicit, concrete trigger phrases, matching the 5 anchor; the 4 anchor's caveat about a less-explicit 'when' does not apply.

5 / 5

Trigger Term Quality

Good keyword coverage: "ARIA labels", "keyboard navigation", "focus management", "color contrast", "form errors", "WCAG compliance", "interactive controls", "forms", "dialogs" are all natural phrases a user would say. A few common synonyms are missing (e.g., "a11y", "screen reader", "alt text"), keeping it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (HTML accessibility) with distinct trigger terms (ARIA, WCAG, keyboard navigation, focus management) that are unlikely to fire for unrelated skills. Minor overlap with a generic frontend/forms skill exists but the WCAG/ARIA vocabulary is unmistakably accessibility-specific.

5 / 5

Total

18

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/fixing-accessibility/SKILL.md

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.