Wcag Audit Patterns
🤖 AI Summary
This skill audits web content against WCAG 2.2 guidelines, identifying violations and providing actionable remediation strategies to meet legal compliance standards like ADA, Section 508, and VPAT.
How to Install
Claude Code:
git clone --depth 1 https://github.com/wshobson/agents.git && cp agents/plugins/accessibility-compliance/skills/wcag-audit-patterns ~/.claude/skills/SKILL.md -rWCAG Audit Patterns
Comprehensive guide to auditing web content against WCAG 2.2 guidelines with actionable remediation strategies.
When to Use This Skill
- Conducting accessibility audits
- Fixing WCAG violations
- Implementing accessible components
- Preparing for accessibility lawsuits
- Meeting ADA/Section 508 requirements
- Achieving VPAT compliance
Core Concepts
1. WCAG Conformance Levels
| Level | Description | Required For |
|---|---|---|
| A | Minimum accessibility | Legal baseline |
| AA | Standard conformance | Most regulations |
| AAA | Enhanced accessibility | Specialized needs |
2. POUR Principles
Perceivable: Can users perceive the content?
Operable: Can users operate the interface?
Understandable: Can users understand the content?
Robust: Does it work with assistive tech?
3. Common Violations by Impact
Critical (Blockers):
├── Missing alt text for functional images
├── No keyboard access to interactive elements
├── Missing form labels
└── Auto-playing media without controls
Serious:
├── Insufficient color contrast
├── Missing skip links
├── Inaccessible custom widgets
└── Missing page titles
Moderate:
├── Missing language attribute
├── Unclear link text
├── Missing landmarks
└── Improper heading hierarchy
Detailed patterns and worked examples
Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.
Best Practices
Do's
- Start early - Accessibility from design phase
- Test with real users - Disabled users provide best feedback
- Automate what you can - 30-50% issues detectable
- Use semantic HTML - Reduces ARIA needs
- Document patterns - Build accessible component library
Don'ts
- Don't rely only on automated testing - Manual testing required
- Don't use ARIA as first solution - Native HTML first
- Don't hide focus outlines - Keyboard users need them
- Don't disable zoom - Users need to resize
- Don't use color alone - Multiple indicators needed
Details
| Category | Security → vulnerability |
| Source | wshobson/agents |
| SKILL.md | View on GitHub → |
| Repo Stars | ★ 37.1K |
| Est. per Skill | 371 (shared across 100 skills from this repo) |
| Difficulty | Intermediate |
| Risk Level | N/A |
Related Skills
seo
SEO: Universal SEO Analysis Skill Comprehensive SEO analysis across all industries (SaaS, local serv
varlock
Varlock Security Skill Secure-by-default environment variable management for Claude Code sessions. R
fix-review
Fix Review Overview Verify that fix commits properly address audit findings without introducing new
solidity-security
Solidity Security Master smart contract security best practices, vulnerability prevention, and secur
Works Well With
Skills from the same repository — often designed to work together
Screen Reader Testing
Screen Reader Testing Practical guide to testing web applications with screen readers for comprehens
Multi Reviewer Patterns
Multi-Reviewer Patterns Patterns for coordinating parallel code reviews across multiple quality dime
Parallel Debugging
Parallel Debugging Framework for debugging complex issues using the Analysis of Competing Hypotheses