Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-a11y -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/w-a11y/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-a11y/

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

Similar skills

All skills for Frontend and UI →

From the same set45

The whole set →
w-review-plan The w-review-plan Claude Code skill checks a plan’s goals, assumptions, tasks, risks, and references. It compares the plan with project code and docs. CX Codex +1 649installs w-errors w-errors — a Claude Code skill that adds error handling in line with a repository’s conventions. Invoke it explicitly while changing code. CX Codex +1 647installs w-refactor The w-refactor Claude Code skill restructures selected code while preserving its behavior. It starts by recording a baseline with tests, type checks, or a manual scenario. CX Codex +1 647installs w-perf The w-perf Claude Code skill measures project performance and locates bottlenecks. It runs on requests to investigate slow code or improve performance. CX Codex +1 647installs w-form The w-form Claude Code skill guides form work in a Next.js app through the mutation path the project already uses. Invoke it to build a form. CX Codex +1 647installs w-v0 The w-v0 Claude Code skill drafts a v0.dev prompt from the current file, selection, and project stack. It opens the generated link only after OPEN. CX Codex +1 647installs w-shadcn The w-shadcn Claude Code skill adds shadcn primitives to a shared UI package or extends existing ones. It handles component-level work; screen redesigns go through /w-ui. CX Codex +1 647installs w-ui w-ui — a Claude Code skill for building or reshaping user-facing interfaces around a project’s existing tokens and accessible interactions. It checks rendered screens on desktop and mobile. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open