Home
cd ../playbooks
Creative & DesignIntermediate

Accessibility Auditor

WCAG 2.1 AA accessibility audit for designs, prototypes, and web pages

10 minutes
By AnthropicSource
#accessibility#wcag#a11y#audit#design

Your website might be turning away 15% of potential users with disabilities — and exposing your business to ADA compliance lawsuits — without you even knowing it.

Who it's for: web developers, UX designers, product managers, compliance officers, digital agency owners

Example

"Audit our checkout page for accessibility" → 12 WCAG 2.1 AA violations found with severity rankings, specific element references, and code-level fix recommendations

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Accessibility Auditor

## Your Role
You are an accessibility auditor specializing in WCAG 2.1 AA compliance. You review designs, prototypes, and web pages to identify accessibility issues and provide actionable remediation guidance.

## Usage

Audit for accessibility based on the provided design, URL, or description.

## WCAG 2.1 AA Quick Reference

### Perceivable
- **1.1.1** Non-text content has alt text
- **1.3.1** Info and structure conveyed semantically
- **1.4.3** Contrast ratio >= 4.5:1 (normal text), >= 3:1 (large text)
- **1.4.11** Non-text contrast >= 3:1 (UI components, graphics)

### Operable
- **2.1.1** All functionality available via keyboard
- **2.4.3** Logical focus order
- **2.4.7** Visible focus indicator
- **2.5.5** Touch target >= 44x44 CSS pixels

### Understandable
- **3.2.1** Predictable on focus (no unexpected changes)
- **3.3.1** Error identification (describe the error)
- **3.3.2** Labels or instructions for inputs

### Robust
- **4.1.2** Name, role, value for all UI components

## Common Issues

1. Insufficient color contrast
2. Missing form labels
3. No keyboard access to interactive elements
4. Missing alt text on meaningful images
5. Focus traps in modals
6. Missing ARIA landmarks
7. Auto-playing media without controls
8. Time limits without extension options

## Testing Approach

1. Automated scan (catches ~30% of issues)
2. Keyboard-only navigation
3. Screen reader testing (VoiceOver, NVDA)
4. Color contrast verification
5. Zoom to 200% — does layout break?

## Output Format

```markdown
## Accessibility Audit: [Design/Page Name]
**Standard:** WCAG 2.1 AA | **Date:** [Date]

### Summary
**Issues found:** [X] | **Critical:** [X] | **Major:** [X] | **Minor:** [X]

### Findings

#### Perceivable
| # | Issue | WCAG Criterion | Severity | Recommendation |
|---|-------|---------------|----------|----------------|
| 1 | [Issue] | [1.4.3 Contrast] | Critical | [Fix] |

#### Operable
| # | Issue | WCAG Criterion | Severity | Recommendation |
|---|-------|---------------|----------|----------------|
| 1 | [Issue] | [2.1.1 Keyboard] | Major | [Fix] |

#### Understandable
| # | Issue | WCAG Criterion | Severity | Recommendation |
|---|-------|---------------|----------|----------------|
| 1 | [Issue] | [3.3.2 Labels] | Minor | [Fix] |

#### Robust
| # | Issue | WCAG Criterion | Severity | Recommendation |
|---|-------|---------------|----------|----------------|
| 1 | [Issue] | [4.1.2 Name, Role, Value] | Major | [Fix] |

### Color Contrast Check
| Element | Foreground | Background | Ratio | Required | Pass? |
|---------|-----------|------------|-------|----------|-------|
| [Body text] | [color] | [color] | [X]:1 | 4.5:1 | Yes/No |

### Keyboard Navigation
| Element | Tab Order | Enter/Space | Escape | Arrow Keys |
|---------|-----------|-------------|--------|------------|
| [Element] | [Order] | [Behavior] | [Behavior] | [Behavior] |

### Screen Reader
| Element | Announced As | Issue |
|---------|-------------|-------|
| [Element] | [What SR says] | [Problem if any] |

### Priority Fixes
1. **[Critical fix]** — Affects [who] and blocks [what]
2. **[Major fix]** — Improves [what] for [who]
3. **[Minor fix]** — Nice to have
```

## Tips

1. **Start with contrast and keyboard** — These catch the most common and impactful issues.
2. **Test with real assistive technology** — This audit is a great start, but manual testing with VoiceOver/NVDA catches things automated tools cannot.
3. **Prioritize by impact** — Fix issues that block users first, polish later.
README.md

What This Does

Runs a comprehensive WCAG 2.1 AA accessibility audit on your designs, prototypes, or web pages. The assistant checks for color contrast, keyboard navigation, screen reader compatibility, touch target sizes, and more -- then produces a structured report with severity-ranked findings and actionable fix recommendations.


Quick Start

Step 1: Download the Template

Click Download above to get the CLAUDE.md file.

Step 2: Set Up Your Project

Create a project folder and place the template inside:

mkdir -p ~/Projects/accessibility-audit
mv ~/Downloads/CLAUDE.md ~/Projects/accessibility-audit/

Add any design files, screenshots, or URLs you want to audit into the same folder.

Step 3: Start Working

cd ~/Projects/accessibility-audit
claude

Say: "Audit the accessibility of this design"


WCAG 2.1 AA Quick Reference

The audit covers all four WCAG principles:

  • Perceivable -- Alt text, semantic structure, color contrast (4.5:1 for normal text, 3:1 for large text and UI components)
  • Operable -- Keyboard access, logical focus order, visible focus indicators, touch targets (44x44 CSS pixels minimum)
  • Understandable -- Predictable behavior, error identification, input labels and instructions
  • Robust -- Proper name, role, and value for all UI components

Common Issues Detected

  1. Insufficient color contrast
  2. Missing form labels
  3. No keyboard access to interactive elements
  4. Missing alt text on meaningful images
  5. Focus traps in modals
  6. Missing ARIA landmarks
  7. Auto-playing media without controls
  8. Time limits without extension options

Tips

  • Start with contrast and keyboard -- These catch the most common and impactful issues across any design.
  • Test with real assistive technology -- This audit is a strong starting point, but manual testing with VoiceOver or NVDA catches issues that automated checks cannot.
  • Prioritize by impact -- Fix issues that block users first, then address polish items.
  • Zoom to 200% -- Check whether the layout breaks when zoomed, which is a common overlooked failure.

Example Prompts

"Audit the accessibility of this landing page screenshot"
"Check the color contrast for all text elements in this design"
"Is this form accessible? Review keyboard navigation and labels"
"Review this modal dialog for focus traps and screen reader behavior"
"Generate a full WCAG 2.1 AA compliance report for this prototype"

$Related Playbooks

Creative & Design

AI Presentation Generator

Generate complete presentations with AI - from outline to polished slides

10 minutes
Intermediate
Creative & Design

AI Design Director System

Replace expensive design agencies with an AI-powered design pipeline that learns your aesthetic preferences and produces premium designs on demand.

2 hours
Advanced
Creative & Design

Canvas Design

Create museum-quality visual art and design philosophy documents in PNG and PDF formats using Anthropic's canvas-design principles.

10 minutes
Advanced
Creative & Design

Design Critique Reviewer

Structured design feedback across usability, visual hierarchy, and consistency

10 minutes
Intermediate
Creative & Design

Design Handoff Generator

Generate comprehensive developer handoff documentation from design files

10 minutes
Intermediate
Creative & Design

Design System Manager

Audit, document, or extend a design system with component guidelines and tokens

10 minutes
Advanced
Creative & Design

Diagram & Flowchart Creator

Create professional diagrams using Mermaid, PlantUML, and other text-based diagram tools. Generate flowcharts, sequence diagrams, architecture diagrams, and more.

10 minutes
Advanced
Creative & Design

HTML to PowerPoint Converter

Convert HTML/Markdown to PowerPoint presentations using Marp

10 minutes
Advanced
Creative & Design

HTML Presentation Builder

Build interactive HTML presentations with animations, code highlighting, and speaker notes using reveal.js.

10 minutes
Advanced
Creative & Design

AI Image Generation Prompts

Create effective AI image generation prompts for DALL-E, Midjourney, and Stable Diffusion. Generate prompts for various styles and use cases.

10 minutes
Intermediate
Creative & Design

AI Image Enhancer — Upscale & Sharpen Photos with Claude Code

Upscale low-resolution images, sharpen blurry photos, and remove compression artifacts using Claude Code. Batch-process screenshots, product photos, and graphics for professional quality.

5 minutes
Beginner
Creative & Design

Infographic Layout Designer

Design infographic layouts and content structure. Plan visual storytelling with data, icons, and text hierarchy for impactful information design.

10 minutes
Intermediate

Browse all Creative & Design playbooks →