How do I install the A11Y Audit skill?

Run npx skillmds add nous-hermeshub/a11y-audit in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is A11Y Audit safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with A11Y Audit?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is A11Y Audit free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published A11Y Audit?

nous-hermeshub (@nous-hermeshub) published this skill. Their other Agent Skills are listed on their SkillMD profile.

A11Y Audit by nous-hermeshub — Agent Skill

Name: A11Y Audit
Rating: 4.2 (5 reviews)
Author: nous-hermeshub

File contents

/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 engineering-team/a11y-audit/skills/a11y-audit/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/skills/a11y-audit/SKILL.md
engineering-team/a11y-audit/skills/a11y-audit/scripts/a11y_scanner.py
engineering-team/a11y-audit/skills/a11y-audit/scripts/contrast_checker.py
engineering-team/a11y-audit/skills/a11y-audit/references/wcag-quick-ref.md
engineering-team/a11y-audit/skills/a11y-audit/references/aria-patterns.md
engineering-team/a11y-audit/skills/a11y-audit/references/framework-a11y-patterns.md

---name: a11y-auditdescription: Scan a frontend project for WCAG 2.2 accessibility violations and fix them. Usage: /a11y-audit [path]license: MIT---# /a11y-auditScan a frontend project for WCAG 2.2 accessibility issues, show fixes, and optionally check color contrast.## Usage```bash/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: ScanRun the a11y scanner on the target directory:```bashpython3 {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: FixFor each finding (starting with critical):1. Read the affected file2. Show the violation with context (before)3. Apply the fix from `engineering-team/a11y-audit/skills/a11y-audit/references/framework-a11y-patterns.md`4. 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 CheckIf CSS files are present, run the contrast checker:```bashpython3 {skill_path}/scripts/contrast_checker.py --batch {path}```For each failing color pair, suggest accessible alternatives.### Step 4: ReportGenerate 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/skills/a11y-audit/SKILL.md`- `engineering-team/a11y-audit/skills/a11y-audit/scripts/a11y_scanner.py`- `engineering-team/a11y-audit/skills/a11y-audit/scripts/contrast_checker.py`- `engineering-team/a11y-audit/skills/a11y-audit/references/wcag-quick-ref.md`- `engineering-team/a11y-audit/skills/a11y-audit/references/aria-patterns.md`- `engineering-team/a11y-audit/skills/a11y-audit/references/framework-a11y-patterns.md`

Frequently asked questions