Slash Command

/a11y-audit

Scans frontend project for WCAG 2.2 accessibility violations, shows fixes, auto-applies with --fix, checks color contrast, generates a11y-report.md.

Html

Css

Python

accessibility

frontend

Install

npx claudepluginhub joshuarweaver/cascade-code-testing-misc --plugin alirezarezvani-claude-skills-7

Prompt Preview

# /a11y-audit

Scan a frontend project for WCAG 2.2 accessibility issues, show fixes, and optionally check color contrast.

## Usage



## What It Does

### Step 1: Scan

Run the a11y scanner on the target directory:



Parse the JSON output. Group findings by severity (critical → serious → moderate → minor).

Display a summary:


### Step 2: Fix

For each finding (starting with critical):

1. Read the affected file
2. Show the violation with context (before)
3. Apply the fix from `references/framework-a11y-patterns.md`
4. Show the result (after)

**Auto-fixable issues** (apply without aski...

Command Content

Other plugins with /a11y-audit

/a11y-audit

Comprehensive accessibility audit — automated axe scan, keyboard navigation check, color contrast review, ARIA audit, and prioritized CRITICAL/HIGH/MEDIUM issue backlog

clarc

/a11y-audit

Audit accessibility of the running React Native app against best practices.

BashReadGrep+1

react-native-foundations

/a11y-audit

Run accessibility audit on components (WCAG 2.1 AA checks)

ReadWriteGlob+2

chakra-react-toolkit

/a11y-audit

Run accessibility and HTML lint audit on files, then provide fix SUGGESTIONS (does NOT modify files) using WCAG/ARIA references

BashReadGlob+2

web-audit-tools

/a11y-audit

Audit a frontend application for WCAG 2.1/2.2 compliance, screen reader compatibility, keyboard accessibility, and inclusive design patterns.

atm

/a11y-audit

Perform a WCAG 2.1 AA accessibility audit on target components covering ARIA, keyboard nav, focus management, contrast, forms, and dynamic content.

frontend-dev

Stats

Stars12801

Forks1693

Last CommitMar 18, 2026

Actions

View Source View Plugin View on GitHub View README

/a11y-audit

Scan a frontend project for WCAG 2.2 accessibility issues, show fixes, and optionally check color contrast.

Usage

/a11y-audit                     # Scan current project
/a11y-audit ./src               # Scan specific directory
/a11y-audit ./src --fix         # Scan and auto-fix what's possible

What It Does

Step 1: Scan

Run the a11y scanner on the target directory:

python3 {skill_path}/scripts/a11y_scanner.py {path} --json

Parse the JSON output. Group findings by severity (critical → serious → moderate → minor).

Display a summary:

A11y Audit: ./src
  Critical: 3 | Serious: 7 | Moderate: 12 | Minor: 5
  Files scanned: 42 | Files with issues: 15

Step 2: Fix

For each finding (starting with critical):

Read the affected file
Show the violation with context (before)
Apply the fix from references/framework-a11y-patterns.md
Show the result (after)

Auto-fixable issues (apply without asking):

Missing alt="" on decorative images
Missing lang attribute on <html>
tabindex values > 0 → set to 0
Missing type="button" on non-submit buttons
Outline removal without replacement → add :focus-visible styles

Issues requiring user input (show fix, ask to apply):

Missing alt text (need description from user)
Missing form labels (need label text)
Heading restructuring (may affect layout)
ARIA role changes (may affect functionality)

Step 3: Contrast Check

If CSS files are present, run the contrast checker:

python3 {skill_path}/scripts/contrast_checker.py --batch {path}

For each failing color pair, suggest accessible alternatives.

Step 4: Report

Generate a markdown report at a11y-report.md:

Executive summary (pass/fail, issue counts)
Per-file findings with before/after diffs
Remaining manual review items
WCAG criteria coverage

Skill Reference

engineering-team/a11y-audit/SKILL.md
engineering-team/a11y-audit/scripts/a11y_scanner.py
engineering-team/a11y-audit/scripts/contrast_checker.py
engineering-team/a11y-audit/references/wcag-quick-ref.md
engineering-team/a11y-audit/references/aria-patterns.md
engineering-team/a11y-audit/references/framework-a11y-patterns.md