a11y-audit

Installation
SKILL.md

Web Accessibility Audit and Non-Breaking Fix Pass

Run an evidence-based WCAG 2.1 AA pass over an app (or a scoped part of it), write a dated audit record, and when asked to implement, apply only changes that are additive and visually non-breaking, quarantining anything that would change the UI into a design-decision list. This two-bucket split is the core of the skill: it lets accessibility work ship without design sign-off stalling it.

Written for React and Tailwind, but the method, lenses, instruments and pitfalls port to any component-based frontend.

Before you start

Read the project's frontend conventions and design-token documentation, and follow any rule the repository states about which docs must be read before writing code. If a previous accessibility audit record exists, read it first so you extend it rather than rediscover it.

Then locate the project's existing a11y primitives, because Phase C depends on them:

Installs
1
GitHub Stars
1
First Seen
Sep 24, 2026