scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-10-07 02:58:13 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/engineering-team/a11y-audit
History
Exact
Claude 552b373bef
refactor(tooling): PR #841 round-3 review — uniform --sample precedence + warnings 
- health_score_calculator + pipeline_analyzer: warn on stderr when --sample
  overrides a provided input (now consistent across all six tools)
- pmf_scorer: --sample checked before --input (matches the batch), with the
  same override warning
- pipeline_analyzer: comment the intentionally stale D-3 fixture deal
- contrast_checker: user-facing --sample help text

https://claude.ai/code/session_01CUWsrUNZP9jpxvAwq67UiT
2026-06-11 16:05:11 +00:00
..
.claude-plugin chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
skills/a11y-audit refactor(tooling): PR #841 round-3 review — uniform --sample precedence + warnings 2026-06-11 16:05:11 +00:00
README.md Dev (#377) 2026-03-18 08:42:53 +01:00
settings.json Dev (#377) 2026-03-18 08:42:53 +01:00

README.md

A11y Audit — WCAG 2.2 Accessibility Audit & Fix

Audit and fix WCAG 2.2 accessibility issues in any frontend project. Covers React, Next.js, Vue, Angular, Svelte, and plain HTML.

Quick Start

# Scan a project
/a11y-audit ./src

# Or use the scripts directly
python3 scripts/a11y_scanner.py ./src
python3 scripts/contrast_checker.py "#1a1a2e" "#ffffff"

Scripts

Script Purpose
a11y_scanner.py Scan HTML/JSX/TSX/Vue/Svelte/CSS for 20+ a11y violations
contrast_checker.py WCAG contrast ratio calculator with AA/AAA checks and --suggest mode

Both are stdlib-only — no pip install needed. CI-friendly exit codes (0 = pass, 1 = blocking issues).

What It Covers

  • Images: missing alt, empty alt on informative images
  • Forms: missing labels, orphan labels, missing fieldset/legend
  • Headings: skipped levels, missing h1, multiple h1s
  • Landmarks: missing main/nav/skip link
  • Keyboard: tabindex > 0, click without keyboard handler
  • ARIA: invalid attributes, aria-hidden on focusable, missing aria-live
  • Color: contrast ratios below AA thresholds
  • Links: empty links, "click here" text
  • Tables: missing headers, missing caption
  • Media: missing captions, autoplay without controls

References

  • references/wcag-quick-ref.md — WCAG 2.2 Level A/AA criteria table
  • references/aria-patterns.md — ARIA roles, live regions, keyboard patterns
  • references/framework-a11y-patterns.md — React, Vue, Angular, Svelte fix patterns

License

MIT