wcag-audit-patterns

Overview

What is wcag-audit-patterns?

wcag-audit-patterns is a practical skill for auditing websites and web applications against WCAG 2.2 accessibility standards. It provides a structured workflow combining automated testing, manual verification, and actionable remediation guidance. This skill is designed for web teams, accessibility specialists, and developers aiming to meet legal and regulatory requirements such as ADA, Section 508, and VPAT compliance.

Who Should Use This Skill?

• Web developers and designers
• Accessibility consultants
• QA teams
• Organizations preparing for accessibility audits or legal compliance

Problems Solved

• Identifies common WCAG violations
• Offers remediation strategies for accessibility issues
• Helps implement accessible design patterns
• Supports compliance with WCAG 2.2, ADA, and Section 508

How to Use

Installation Steps

To install wcag-audit-patterns, use the following command:

npx skills add https://github.com/wshobson/agents --skill wcag-audit-patterns

Getting Started

1. Begin by reviewing the SKILL.md file for a comprehensive overview of the audit workflow and remediation strategies.
2. Explore supporting files such as README.md, AGENTS.md, and metadata.json for additional context and configuration options.
3. Check any available rules/, resources/, or references/ folders for detailed audit criteria and supporting materials.

Adapting the Workflow

• Customize the audit process to fit your project’s needs, tools, and constraints.
• Use the provided guidance to prioritize critical issues such as missing alt text, keyboard accessibility, and form labeling.
• Reference the POUR principles (Perceivable, Operable, Understandable, Robust) to ensure comprehensive coverage.

Key Concepts

WCAG Conformance Levels

• A: Minimum accessibility, legal baseline
• AA: Standard conformance, required by most regulations
• AAA: Enhanced accessibility, for specialized needs

Common Violations

• Critical: Missing alt text, no keyboard access, missing form labels, auto-playing media
• Serious: Insufficient color contrast, missing skip links, inaccessible custom widgets
• Moderate: Missing language attribute, unclear link text

FAQ

Where can I find detailed audit patterns and remediation steps?

Open the Files tab and review SKILL.md for actionable guidance. Supporting files and folders provide additional context and references.

Is wcag-audit-patterns suitable for automated and manual audits?

Yes. The skill combines automated testing with manual verification and remediation advice, making it suitable for comprehensive accessibility audits.

What standards does wcag-audit-patterns cover?

It focuses on WCAG 2.2 guidelines and supports compliance with ADA, Section 508, and VPAT requirements.

How do I adapt wcag-audit-patterns to my project?

Follow the workflow in SKILL.md and customize the process based on your repository, tools, and accessibility goals.

What are the main benefits of using wcag-audit-patterns?

• Structured audit workflow
• Prioritization of critical accessibility issues
• Practical remediation strategies
• Support for legal and regulatory compliance