w-a11y — Claude Code skill for UI accessibility audits
The w-a11y Claude Code skill checks UI accessibility against a repository’s docs and tests. It reports findings by default and changes code only when asked to fix issues.
MIT 647 installs ★ 1 updated 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a claude-codeWhat w-a11y does
w-a11y examines the changed interface for semantic structure, keyboard access, accessible names, and focus behavior. It first reads the project’s testing and frontend docs to locate any documented accessibility gate, then runs existing accessibility or component tests. If the repository has no named gate, it reports that and runs only the tests already present.
The skill is report-only unless a fix is requested. When authorized, it makes the smallest semantic or ARIA change that satisfies the documented gate. It names a WCAG A, AA, or AAA level only when the repository docs specify one. If a fix changes behavior or commands, it points to /w-docs for the documentation update.
What it helps with
- audit semantics in changed UI
- find keyboard access and focus issues
- run existing accessibility or component tests
- fix UI against a documented accessibility gate
Example prompts for the agent
- Audit the changed UI against this repository’s accessibility docs and tests.
- Check keyboard access, accessible names, and focus in the updated interface.
- Fix the reported accessibility issues using the project’s documented gate.
How to install w-a11y
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a claude-code2Manually: put the files in place
~/.claude/skills/w-a11y/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-a11y/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a codex2Manually: put the files in place
.agents/skills/w-a11y/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a cursor2Manually: put the files in place
.cursor/skills/w-a11y/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-a11y2Manually: put the files in place
.github/skills/w-a11y/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-a11yManually: put the files in place
.devin/skills/w-a11y/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about w-a11y
How do I install w-a11y in Claude Code?
Run npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a claude-code. The skill file is at ~/.claude/skills/w-a11y/SKILL.md.
What does w-a11y do?
It checks changed UI against repository accessibility guidance and existing tests, then reports its findings. Code changes happen only when requested.
When does w-a11y report a WCAG level?
Only when the repository documentation specifies level A, AA, or AAA. It does not assign a level on its own.
Source text
SKILL.md · MIT
--- name: w-a11y description: Audit UI against repository a11y docs and tests; do not invent a WCAG level. disable-model-invocation: true --- Audit the specified UI against accessibility docs and existing a11y tests. Stay report-only unless the user asked to fix. 1. Read testing and frontend docs for the named a11y gate. If none exists, report that and run only existing repo tests. 2. Inspect semantic structure, keyboard access, names, and focus on changed UI. 3. Run the repository's a11y or component tests. Do not declare WCAG A/AA/AAA unless the repository docs name that level. 4. If fixes are authorized, apply the smallest semantic/ARIA change that meets the documented gate. 5. Docs: `/w-docs` if behavior or commands changed.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills