# Review Accessibility > Audit for WCAG 2.1 AA compliance covering semantic HTML, ARIA, keyboard navigation, color contrast, screen readers, and focus management. Checklist organized by POUR principles. - Skill: `deankelly751/review-accessibility` (Agent Skill) - Install (CLI): `npx skillmds@latest add deankelly751/review-accessibility` - Raw SKILL.md: https://api.skillmd.com/api/skills/deankelly751/review-accessibility/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: DeanKelly751 (https://skillmd.com/u/deankelly751) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/deankelly751/review-accessibility --- # Accessibility Review Evaluate UI code for WCAG 2.1 Level AA compliance, organized by the POUR principles: Perceivable, Operable, Understandable, Robust. **Cross-reference**: `frontend/knowledge-accessibility` for WCAG guidelines, ARIA patterns, and semantic HTML. ## When to Use - Before merging UI changes (new components, layout changes, interactive elements) - When building forms, modals, navigation, or data tables - During periodic accessibility audits - Before launching user-facing features ## Severity Levels | Level | Meaning | |-------|---------| | **CRITICAL** | WCAG 2.1 AA failure — content is inaccessible to some users, legal risk — fix before merge | | **WARNING** | Usability issue for assistive tech users — fix soon | | **SUGGESTION** | Enhancement that improves experience — implement when practical | ## Review Checklist by POUR Principle ### Perceivable _Can users perceive all content regardless of ability?_ | Check | WCAG | Severity | |-------|------|----------| | Images have descriptive `alt` text (decorative images use `alt=""`) | 1.1.1 | CRITICAL | | Video/audio has captions or transcripts | 1.2.1 | CRITICAL | | Color is not the sole means of conveying information | 1.4.1 | CRITICAL | | Text color contrast ratio ≥ 4.5:1 (normal text), ≥ 3:1 (large text) | 1.4.3 | CRITICAL | | Non-text contrast (icons, borders, form controls) ≥ 3:1 | 1.4.11 | WARNING | | Text can be resized to 200% without loss of content | 1.4.4 | WARNING | | Content reflows at 320px width without horizontal scroll | 1.4.10 | WARNING | | No information conveyed only through sensory characteristics ("click the red button") | 1.3.3 | WARNING | | Content order is meaningful in DOM (matches visual order) | 1.3.2 | WARNING | ### Operable _Can users navigate and interact using keyboard, voice, or assistive tech?_ | Check | WCAG | Severity | |-------|------|----------| | All interactive elements are keyboard accessible | 2.1.1 | CRITICAL | | No keyboard traps (user can always Tab/Escape out) | 2.1.2 | CRITICAL | | Focus order follows logical reading sequence | 2.4.3 | CRITICAL | | Focus indicator is visible (not suppressed via `outline: none` without replacement) | 2.4.7 | CRITICAL | | Skip-to-main-content link provided | 2.4.1 | WARNING | | Page titles are descriptive | 2.4.2 | WARNING | | Link text is descriptive (no "click here") | 2.4.4 | WARNING | | Touch targets ≥ 44x44 CSS pixels | 2.5.5 | WARNING | | Animations respect `prefers-reduced-motion` | 2.3.3 | WARNING | | No content that flashes more than 3 times per second | 2.3.1 | CRITICAL | ### Understandable _Can users understand content and predict interface behavior?_ | Check | WCAG | Severity | |-------|------|----------| | `lang` attribute set on `` | 3.1.1 | WARNING | | Form inputs have associated `