# Auditing Website Accessibility

> Audits website accessibility for WCAG 2.1 AA compliance, generating findings and code fixes. Use when reviewing accessibility, keyboard navigation, screen reader compatibility, or inclusive design.

- Skill: `qte77/auditing-website-accessibility` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add qte77/auditing-website-accessibility`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qte77/auditing-website-accessibility/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: qte77 (https://skillmd.com/u/qte77)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/qte77/auditing-website-accessibility

---


# Website Accessibility Audit

**Target**: $ARGUMENTS

Conducts focused accessibility audits against WCAG 2.1 AA and generates
implementable code fixes. No over-analysis.

## Audit Areas

### Keyboard Navigation

- Tab order and focus management
- Skip links and keyboard shortcuts
- Focus indicators and styling

### Screen Reader Compatibility

- ARIA landmarks and roles
- Semantic HTML structure
- Alternative text and descriptions
- Live region announcements

### Visual Accessibility

- Color contrast ratios (4.5:1 minimum)
- Responsive zoom (200% minimum)
- Motion and animation controls

### Forms and Data Tables

- Label associations and error handling
- Fieldset/legend usage and required field indicators
- Table header associations and caption elements

## Workflow

1. **Identify scope** from $ARGUMENTS (URL, file, or directory)
2. **Run automated checks** (axe-core, HTML validation, contrast ratios)
3. **Manual review** (keyboard-only navigation, screen reader, 200% zoom)
4. **Classify findings** by WCAG level and impact
5. **Generate code fixes** for each finding

## Output Format

### Findings

```text
CRITICAL (WCAG Level A)
- [Issue] - Impact: [High/Medium/Low] - Element: [selector]
  Fix: [Code snippet]
  WCAG: [Success Criterion]

COMPLIANCE (WCAG Level AA)
- [Issue] - Impact: [High/Medium/Low] - Element: [selector]
  Fix: [Code snippet]
  WCAG: [Success Criterion]
```

### Implementation Checklist

```text
- [ ] [Fix description] - Impact: [High/Medium/Low]
```

Group fixes by: Keyboard Navigation, Screen Readers, Visual, Forms/Tables.

## Rules

- Prioritize Level A violations before Level AA
- Every finding must include a specific, implementable code fix
- Test keyboard navigation and screen reader paths manually
- Keep output concise: findings + fixes + checklist only