An accessibility audit command for checking a web page or interface component against WCAG 2.2, the standard for making websites usable by people with disabilities.

Use it to inspect a page or component at the AA or AAA level and report accessibility findings and Lighthouse results.

It combines automated checks with manual review areas such as keyboard access, color contrast, and ARIA labels.

a11y-audit — Command for Claude Code by TheBeardedBearSAS

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo

git clone --depth 1 https://github.com/TheBeardedBearSAS/claude-craft

Made for: Claude Code.

Or install claude-craft, the plugin that ships this one along with the rest of its 56 skills, 94 commands, 47 agents, 5 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/commands/thebeardedbearsas/claude-craft/a11y-audit/github.svg)](https://agentmods.dev/commands/thebeardedbearsas/claude-craft/a11y-audit)

Your own site

<a href="https://agentmods.dev/commands/thebeardedbearsas/claude-craft/a11y-audit"><img src="https://agentmods.dev/badge/commands/thebeardedbearsas/claude-craft/a11y-audit/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/commands/thebeardedbearsas/claude-craft/a11y-audit"><img src="https://agentmods.dev/badge/commands/thebeardedbearsas/claude-craft/a11y-audit.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 10 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 2,725 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00010	$0.02725
Opus 5	$0.00005	$0.01362
Sonnet 5	$0.00002	$0.00545
Haiku 4.5	$0.00001	$0.00272

Measured 6d ago against content hash 3e843c651f29, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

a11y-audit scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/commands/uiux/a11y-audit.md · 283 lines

How it starts

The opening of the file, as written. The whole thing — 283 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Audit Accessibilité WCAG 2.2 AAA

Tu es un Expert Accessibilité certifié. Tu dois réaliser un audit complet d'accessibilité selon les critères WCAG 2.2 niveau AAA.

Arguments

$ARGUMENTS

Arguments :

Chemin vers la page/composant à auditer
(Optionnel) Niveau : AA ou AAA (défaut: AAA)
(Optionnel) Focus : all, keyboard, contrast, aria

Exemple : /uiux:a11y-audit src/pages/Home.tsx AAA ou /uiux:a11y-audit src/components/Modal.tsx AA keyboard

MISSION

Étape 1 : Audit automatisé

# Exécuter les outils automatisés
npx axe-cli {URL}
npx pa11y {URL} --standard WCAG2AAA
npx lighthouse {URL} --only-categories=accessibility

# Vérifier le score Lighthouse
# Objectif : 100/100 sur les 4 catégories

Étape 2 : Audit manuel WCAG 2.2

══════════════════════════════════════════════════════════════
♿ AUDIT ACCESSIBILITÉ WCAG 2.2 AAA
══════════════════════════════════════════════════════════════

Page/Composant : {nom}
Date : {date}
Auditeur : Claude (Expert A11y)
Niveau cible : AAA + Lighthouse 100/100

──────────────────────────────────────────────────────────────
📊 SCORES
──────────────────────────────────────────────────────────────

### Lighthouse
| Catégorie | Score | Objectif | Status |
|-----------|-------|----------|--------|
| Performance | /100 | 100 | ✅/❌ |
| Accessibility | /100 | 100 | ✅/❌ |
| Best Practices | /100 | 100 | ✅/❌ |
| SEO | /100 | 100 | ✅/❌ |

### WCAG 2.2
| Niveau | Critères | Conformes | Non-conformes |
|--------|----------|-----------|---------------|
| A | 30 | {X} | {Y} |
| AA | 20 | {X} | {Y} |
| AAA | 28 | {X} | {Y} |

──────────────────────────────────────────────────────────────
1️⃣ PERCEPTIBLE
──────────────────────────────────────────────────────────────

### 1.1 Alternatives textuelles

#### 1.1.1 Contenu non textuel (A)
| Élément | Alt text | Status | Action |
|---------|----------|--------|--------|
| img.logo | "Logo {nom}" | ✅ | - |
| img.hero | "" (manquant) | ❌ | Ajouter alt descriptif |
| img.icon | aria-hidden="true" | ✅ | - |

### 1.3 Adaptable

#### 1.3.1 Information et relations (A)
| Vérification | Status | Détail |
|--------------|--------|--------|
| Structure headings | ✅/❌ | h1 → h2 → h3 séquentiel |
| Landmarks ARIA | ✅/❌ | header, nav, main, footer |
| Listes sémantiques | ✅/❌ | ul/ol/dl appropriés |
| Tableaux | ✅/❌ | th, scope, caption |
| Formulaires | ✅/❌ | label + fieldset/legend |

### 1.4 Distinguable

#### 1.4.3 Contraste minimum (AA) / 1.4.6 Contraste amélioré (AAA)
| Élément | Couleurs | Ratio | Requis | Status |
|---------|----------|-------|--------|--------|
| Body text | #333 / #fff | 12.6:1 | 7:1 | ✅ |
| Muted text | #666 / #fff | 5.7:1 | 7:1 | ❌ |
| Button primary | #fff / #3B82F6 | 4.5:1 | 4.5:1 | ✅ |
| Placeholder | #9CA3AF / #fff | 2.9:1 | 4.5:1 | ❌ |

#### 1.4.10 Reflow (AA)
| Test | Status | Problème |
|------|--------|----------|
| 320px width | ✅/❌ | {scroll horizontal ?} |
| 400% zoom | ✅/❌ | {contenu coupé ?} |

#### 1.4.11 Contraste non-textuel (AA)
| Élément UI | Ratio | Status |
|------------|-------|--------|
| Input border | 3:1 | ✅/❌ |
| Button border | 3:1 | ✅/❌ |
| Icon action | 3:1 | ✅/❌ |
| Focus ring | 3:1 | ✅/❌ |

──────────────────────────────────────────────────────────────
2️⃣ UTILISABLE
──────────────────────────────────────────────────────────────

### 2.1 Accessibilité clavier

#### 2.1.1 Clavier (A) / 2.1.3 Clavier sans exception (AAA)
| Élément | Tab | Enter | Escape | Arrows | Status |
|---------|-----|-------|--------|--------|--------|
| Links | ✅ | ✅ | - | - | ✅ |
| Buttons | ✅ | ✅ | - | - | ✅ |
| Inputs | ✅ | ✅ | - | - | ✅ |
| Dropdown | ✅ | ✅ | ✅ | ✅ | ❌ |
| Modal | ✅ | ✅ | ✅ | - | ✅ |
| Custom div | ❌ | ❌ | - | - | ❌ |

#### 2.1.2 Pas de piège clavier (A)
| Zone | Entrée | Sortie | Status |
|------|--------|--------|--------|
| Modal | Focus trap OK | Escape OK | ✅ |
| Dropdown | Tab OK | Tab/Escape OK | ✅ |
| Sidebar | Tab OK | Tab OK | ✅ |

### 2.4 Navigable

#### 2.4.1 Bypass blocks (A)
| Skip link | Destination | Status |
|-----------|-------------|--------|
| "Aller au contenu" | #main-content | ✅/❌ |
| "Aller à la navigation" | #nav | ✅/❌ |

#### 2.4.3 Ordre du focus (A)
| Séquence | Attendu | Actuel | Status |
|----------|---------|--------|--------|
| 1 | Skip link | Skip link | ✅ |
| 2 | Logo | Logo | ✅ |
| 3 | Nav item 1 | Nav item 1 | ✅ |
| ... | ... | ... | ... |

#### 2.4.7 Focus visible (AA) / 2.4.11 Focus amélioré (AA)
| Élément | Outline | Offset | Ratio | Status |
|---------|---------|--------|-------|--------|
| Links | 2px solid | 2px | 3:1 | ✅ |
| Buttons | 2px solid | 2px | 3:1 | ✅ |
| Inputs | 2px solid | 0 | 3:1 | ✅ |
| Cards | ❌ | - | - | ❌ |

#### 2.5.5 Taille cible (AAA)
| Élément | Taille | Min requis | Status |
|---------|--------|------------|--------|
| Buttons | 44×40px | 44×44px | ❌ |
| Links menu | 120×48px | 44×44px | ✅ |
| Icon buttons | 32×32px | 44×44px | ❌ |
| Checkboxes | 24×24px | 44×44px | ❌ |

──────────────────────────────────────────────────────────────
3️⃣ COMPRÉHENSIBLE
──────────────────────────────────────────────────────────────

### 3.1 Lisible

#### 3.1.1 Langue page (A)
```html
<html lang="fr"> <!-- ✅ Présent -->

3.1.2 Langue des parties (AA)

Élément	Langue	lang attr	Status
Citation EN	Anglais	❌	❌
Mot technique	Anglais	❌	⚠️

3.3 Assistance à la saisie

3.3.1 Identification erreurs (A)

Champ	Message erreur	En texte	Status
Email	"Email invalide"	✅	✅
Password	Border rouge seule	❌	❌

3.3.2 Labels ou instructions (A)

Input	Label	Association	Status
Email	"Email"	htmlFor OK	✅
Search	❌	Pas de label	❌
Phone	Placeholder seul	Pas de label	❌

────────────────────────────────────────────────────────────── 4️⃣ ROBUSTE ──────────────────────────────────────────────────────────────

4.1.2 Nom, rôle, valeur (A)

Composant	role	aria-*	Status
Modal	dialog	aria-modal, aria-labelledby	✅
Dropdown	listbox	aria-expanded, aria-activedescendant	✅
Tabs	tablist/tab	aria-selected, aria-controls	❌
Accordion	-	aria-expanded	❌

4.1.3 Messages d'état (AA)

Message	aria-live	aria-atomic	Status
Toast success	polite	true	✅
Toast error	assertive	true	✅
Loading	polite	false	❌
Form errors	assertive	-	❌

────────────────────────────────────────────────────────────── ❌ VIOLATIONS CRITIQUES (Bloquantes) ──────────────────────────────────────────────────────────────

#	Critère	Élément	Description	Remédiation
1	1.4.6	.text-muted	Contraste 5.7:1 < 7:1	color: #595959
2	2.5.5	.btn-icon	Taille 32px < 44px	min-width: 44px
3	3.3.2	input[type="search"]	Pas de label	Ajouter label

────────────────────────────────────────────────────────────── ⚠️ VIOLATIONS MAJEURES ──────────────────────────────────────────────────────────────

#	Critère	Élément	Description	Remédiation
4	2.1.1	.card-clickable	div non focusable	Utiliser button
5	4.1.2	.tabs	ARIA incorrect	Ajouter role="tablist"

────────────────────────────────────────────────────────────── ℹ️ VIOLATIONS MINEURES ──────────────────────────────────────────────────────────────

#	Critère	Élément	Description	Remédiation
6	3.1.2	blockquote	Texte EN sans lang	lang="en"

────────────────────────────────────────────────────────────── ✅ POINTS CONFORMES NOTABLES ──────────────────────────────────────────────────────────────

Structure sémantique correcte (headings, landmarks)
Skip link présent et fonctionnel
Focus trap correct sur les modales
Messages d'erreur en texte clair

────────────────────────────────────────────────────────────── 🎯 PLAN DE REMÉDIATION ──────────────────────────────────────────────────────────────

Priorité 1 - Critiques (cette semaine)

Corriger contraste .text-muted → #595959
Agrandir touch targets à 44px minimum
Ajouter labels aux inputs sans label

Priorité 2 - Majeurs (ce sprint)

Remplacer div cliquables par button
Corriger ARIA sur composant Tabs
Ajouter aria-live sur loading states

Priorité 3 - Mineures (backlog)

Ajouter lang="en" sur textes anglais

Read the full file on GitHub · 283 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

6d ago First seen · 283 lines · 10 tokens per session scan A 3e843c651f29

Subscribe to this mod's changes

a11y-audit is a command published in the GitHub repository TheBeardedBearSAS/claude-craft (105 stars, last pushed 7d ago), licensed MIT. It adds 10 tokens to every session and 2,725 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Claude Code E2E testing Frontend Testing agents ai-tools bmad clean-architecture ddd

test-suite

Run comprehensive test suite with coverage analysis.

travisjneuman/.claude · 7 tokens

a11y-audit

Web accessibility (WCAG 2.1) audit command. axe-core-based checks via PageSpeed Insights.

fatihkan/badi · 0 tokens

responsive

Check that a Divi 5 page works across device sizes (small phones, iPhones, tablets, laptops, widescreen, ultrawide). Uses live viewport testing via a browser MCP server (Chrome DevTools or Playwright) when one is available; falls back to static CSS analysis when not.

cjsimon2/Divi5-ToolKit · 63 tokens

a11y-audit

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

Audit Accessibilité WCAG 2.2 AAA

Arguments

MISSION

Étape 1 : Audit automatisé

Étape 2 : Audit manuel WCAG 2.2

3.1.2 Langue des parties (AA)

3.3 Assistance à la saisie

3.3.1 Identification erreurs (A)

3.3.2 Labels ou instructions (A)

4.1.2 Nom, rôle, valeur (A)

4.1.3 Messages d'état (AA)

Priorité 1 - Critiques (cette semaine)

Priorité 2 - Majeurs (ce sprint)

Priorité 3 - Mineures (backlog)

What this file has done since we first saw it

Other commands, from other repositories

test-suite

a11y-audit

responsive

svelte:test-setup

svelte:test

stark-qa