# Wcag Audit Patterns

> Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

Source: https://skillsagentes.com/skills/wshobson/agents/wcag-audit-patterns
Repository: https://github.com/wshobson/agents
Author: wshobson
License: MIT
Updated: hace 2 meses
Context cost: 56 tok installed, 628 tok once triggered, 3.1k tok with every bundled file
Bundle: 2 files, 12 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add wshobson/agents --skill wcag-audit-patterns --agent claude-code
```

## What it does

- Guía auditorías de accesibilidad web según WCAG 2.2 con niveles de conformidad A/AA/AAA
- Aplica los principios POUR (Perceivable, Operable, Understandable, Robust) para evaluar contenido
- Clasifica violaciones comunes por impacto (crítico, serio, moderado) con ejemplos
- Ofrece buenas prácticas y errores a evitar en remediación de accesibilidad
- Remite a references/details.md para patrones detallados y ejemplos trabajados

## Use it when

- Al realizar auditorías de accesibilidad
- Al corregir violaciones de WCAG
- Al implementar componentes o patrones de diseño accesibles
- Al prepararse para cumplir ADA/Section 508 o lograr conformidad VPAT

## What triggers it

- "Audita este sitio contra WCAG 2.2 nivel AA"
- "Ayúdame a corregir los problemas de contraste y foco de teclado"
- "¿Qué necesito para cumplir con Section 508 en mi web?"
- "Revisa este formulario para ver si tiene etiquetas accesibles"

## Files

- SKILL.md — 2 KB
- references/details.md — 10 KB

## SKILL.md

Reproduced verbatim from wshobson/agents under MIT. This section is the upstream document and is in English.

# WCAG 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

---

Skills Agentes — https://skillsagentes.com/skills/wshobson/agents/wcag-audit-patterns