accessibility-checker

name	accessibility-checker
description	Audit web pages for WCAG 2.1 compliance. Use when the user asks about accessibility, a11y, WCAG, screen readers, or contrast issues.

Accessibility Checker

Audit web applications for WCAG 2.1 compliance and accessibility issues.

Description

This skill performs accessibility audits on web pages, checking against WCAG 2.1 guidelines (Level A and AA). It identifies issues, explains their impact on users with disabilities, and provides specific remediation guidance.

Instructions

When the user provides a URL or HTML content:

1. Structural Audit: Check the HTML structure for semantic correctness
2. WCAG Compliance Check: Evaluate against key WCAG 2.1 criteria
3. Assistive Technology Testing: Verify screen reader compatibility
4. Keyboard Navigation: Test tab order and keyboard operability
5. Generate Report: Provide findings with severity, WCAG criterion, and fix

Checklist

Perceivable (WCAG 1.x)

• All images have meaningful alt text (1.1.1)
• Video/audio has captions or transcripts (1.2.x)
• Content is structured with proper headings (1.3.1)
• Color is not the only means of conveying information (1.4.1)
• Text has sufficient color contrast (1.4.3) — minimum 4.5:1 for normal text, 3:1 for large text
• Text can be resized to 200% without loss (1.4.4)
• No images of text (1.4.5)

Operable (WCAG 2.x)

• All functionality available via keyboard (2.1.1)
• No keyboard traps (2.1.2)
• Skip navigation links present (2.4.1)
• Page titles are descriptive (2.4.2)
• Focus order is logical (2.4.3)
• Link purpose is clear from text (2.4.4)
• Focus indicators are visible (2.4.7)

Understandable (WCAG 3.x)

• Page language is specified (3.1.1)
• Form inputs have labels (3.3.2)
• Error messages are descriptive (3.3.1)
• Error suggestions provided (3.3.3)

Robust (WCAG 4.x)

• Valid HTML (4.1.1)
• ARIA roles and properties are correct (4.1.2)
• Status messages use ARIA live regions (4.1.3)

Output Format

# Accessibility Audit Report
**URL**: [url]
**Date**: [date]
**Standard**: WCAG 2.1 Level AA

## Compliance Summary
| Level | Criteria Checked | Pass | Fail | N/A |
|-------|-----------------|------|------|-----|
| A | X | X | X | X |
| AA | X | X | X | X |

## Issues Found
### [SEVERITY] Issue Title
- **WCAG Criterion**: [number and name]
- **Level**: A / AA
- **Element**: [HTML element or selector]
- **Issue**: [Description]
- **Impact**: [Who is affected and how]
- **Fix**: [Specific code change needed]

Example Usage

Run an accessibility audit on https://mysite.com/login

Check this HTML form for WCAG 2.1 AA compliance: [paste HTML]