CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

accessibility-audit

Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles. Use this skill whenever the user wants to audit accessibility, review WCAG compliance, fix accessibility issues, prepare for accessibility certification, address an accessibility lawsuit risk, or systematically improve a site's accessibility. Triggers on accessibility audit, WCAG audit, a11y audit, accessibility compliance, ADA compliance, screen reader test, keyboard navigation, accessibility report, fix accessibility, axe scan. Also triggers when accessibility issues have been reported and need systematic remediation.

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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 well-organized, methodology-driven audit skill with concrete checklists, named tools, and clean one-level-deep references that are all real and well-signaled. It is held back from excellent by absent CLI commands for its named tools, duplication between the inline principles checks and the WCAG quick-reference file, and no post-remediation verification step in the workflow.

Suggestions

Add executable invocations for the named tools — e.g., `npx pa11y <url>` for batch scans and a specific contrast checker (e.g., Chrome DevTools contrast ratio picker) instead of the vague "use a contrast checker".

Trim the inline four-principles audit checks to a brief framework orientation and defer criterion-level detail to references/wcag-quick-reference.md, removing the near-verbatim duplication of its 1.1.1/1.3.x checks.

Append a verification step to the workflow: after remediation, re-run automated scans and spot-check the fixed flows to confirm the issues are resolved before closing them out.

DimensionReasoningScore

Conciseness

The body is dense, checklist-driven, and free of padded prose or library comparisons, but the ~45-line four-principles section restates WCAG criteria Claude already knows and substantially duplicates references/wcag-quick-reference.md (e.g., the inline alt-text checks mirror the reference's 1.1.1 checks almost verbatim). That duplication is a minor token cost, not the noticeable verbosity of the 3 anchor.

4 / 5

Actionability

Guidance is highly concrete — named tools (axe DevTools, Lighthouse, WAVE, Pa11y), exact keyboard interactions (Tab/Shift+Tab, Enter, Space, Escape), exact ratios (4.5:1, 3:1), and exact values (200% zoom, 320px reflow) — meeting the mostly-executable 4 anchor. It misses 5 because commands are not copy-paste ready: Pa11y is a CLI with no invocation given, and "use a contrast checker" names no specific tool.

4 / 5

Workflow Clarity

The 10-step workflow is clearly sequenced with per-stage test checklists, a severity rubric, and a data-availability rule ("state the gap per the data-availability rule") acting as a checkpoint. It stays at 4 rather than 5 because there is no verification or feedback loop after remediation — no step to re-scan or re-test to confirm fixes — and step 7's scoring step has no explicit checkpoint; the audit is read-only, so the destructive/batch cap at 3 does not apply.

4 / 5

Progressive Disclosure

Structure is good: three real, one-level-deep reference files (verified present in references/), clearly signaled both inline at workflow step 9 and in a dedicated Reference files section with content descriptions, and aria-patterns.md explicitly expands the inline checks. It misses 5 because the inline four-principles checklist overlaps the quick-reference file's stated purpose ("Condensed WCAG 2.1 AA criteria with audit checks"), so some criterion-level content that should live only in the reference is duplicated inline.

4 / 5

Total

16

/

20

Passed

Description

95%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 strong description that explicitly answers both what and when with an unusually thorough, synonym-rich trigger list and a clear, distinctive niche. The only notable gap is that it never names its concrete outputs (audit report and remediation plan), which keeps specificity at 4 rather than 5.

DimensionReasoningScore

Specificity

"Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles" names the domain plus the audit action with an enumerated four-principle scope, and the trigger list implies several more actions (review WCAG compliance, fix accessibility issues, prepare for certification). It falls short of the 5 anchor because the concrete deliverables (audit report, remediation plan) are not stated, and above 3 because it lists more than 1-2 specific actions with broad coverage.

4 / 5

Completeness

Both parts are explicit: the what ("Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles") and the when ("Use this skill whenever the user wants to audit accessibility, review WCAG compliance, fix accessibility issues, prepare for accessibility certification, address an accessibility lawsuit risk, or systematically improve a site's accessibility"). This matches the anchor-5 pattern of what plus a concrete 'Use when...' trigger clause, so 4 (when could be more explicit) clearly does not fit.

5 / 5

Trigger Term Quality

The explicit trigger list covers ten natural phrases including synonyms users actually say: "accessibility audit, WCAG audit, a11y audit, accessibility compliance, ADA compliance, screen reader test, keyboard navigation, accessibility report, fix accessibility, axe scan" — jargon synonyms (a11y, ADA) and a tool name (axe) are all present. Only marginal terms like "Section 508" or "make my site accessible" are absent, which does not drop it below comprehensive coverage.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — WCAG/accessibility auditing — and the trigger terms (a11y, WCAG, ADA, screen reader, axe) point squarely at this skill rather than generic QA or design skills. Only borderline terms like "keyboard navigation" could plausibly reach a frontend skill, which is minimal conflict risk fitting the 5 anchor.

5 / 5

Total

19

/

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

rampstackco/claude-skills

Path

skills/accessibility-audit/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.