accessibility-auditor

Files (3)

• LICENSE.txt
• SKILL.md
• examples.md · references/

SKILL.md (first lines)

# Accessibility Auditor

Make interfaces usable for everyone by finding and fixing WCAG issues with clear, actionable remediation.

## Quick Start
1) Scope the surface area (page(s), flow, or component set) and the target level (WCAG 2.1 AA by default).
2) Audit in this order: structure → keyboard → contrast → forms → media → ARIA.
3) Report issues as: **Problem → Impact → Fix → Verification**.

## Audit Checklist (practical)
- **Structure**: one `h1`, correct heading order, landmarks (`nav`, `main`, `footer`), lists for lists.
- **Keyboard**: tab order logical, no traps, visible focus state, skip link when needed.
- **Contrast**: text ≥ 4.5:1 (AA), large text ≥ 3:1, UI elements ≥ 3:1.
- **Forms**: every input has a label; errors are announced and tied to fields.
- **Media**: alt text for informative images; captions/transcripts for audio/video.
- **ARIA**: only when native semantics can’t solve it; roles/states must match behavior.

## Recommended Workflow
1) **Static review**: check semantics in markup and component structure.
2) **Keyboard pass**: navigate every interactive control without a mouse.
3) **Screen reader spot check**: validate names, roles, and announcements.
4) **Contrast pass**: verify text and UI component contrast ratios.
5) **Document fixes**: include exact file/line (if codebase) and the change required.

## Output Format (default)
- **Summary**: pass/fail and the highest-risk issues.
- **Findings**: numbered list with severity (High/Med/Low) and fix guidance.
- **Verification steps**: how to confirm each fix.

## Guardrails
- Prefer native HTML semantics over ARIA.
- Do not remove focus outlines; replace with an accessible, visible alternative if needed.
- If a fix changes behavior, call out any product impact explicitly.

## References
- Extended examples: `references/examples.md`

From vadimcomanescu/codex-skills, MIT.

More from vadimcomanescu/codex-skills