accessibility-check
Quick WCAG accessibility scan of any URL. Checks color contrast, missing alt text, keyboard navigation, ARIA labels, heading hierarchy, and focus indicators. Produces a graded report. Uses Playwright MCP only — no signup.
How do I install this agent skill?
npx skills add https://github.com/quality-max/free-qa-skills --skill accessibility-checkIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill performs accessibility scans on external websites. While the logic is benign, processing external web content introduces a surface for indirect prompt injection.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Accessibility Check
Scan any web page for WCAG accessibility violations. No signup required.
Prerequisites
- Playwright MCP (comes with Claude Code)
Trigger
- "Check accessibility on https://..."
- "WCAG scan this page"
- "Is my site accessible?"
Workflow
- Navigate to the URL using
mcp__playwright__browser_navigate - Take a snapshot with
mcp__playwright__browser_snapshot - Check each of these categories:
Checks
Images & Media
- Every
imgmust havealtattribute - Decorative images should have
alt="" videoandaudioshould have captions/transcripts
Headings
- Page should have exactly one
h1 - Headings should not skip levels (h1 → h3 without h2)
- Headings should be descriptive, not empty
Forms
- Every input must have a visible
labeloraria-label - Required fields should be marked
- Error messages should be associated with fields
Keyboard
- All interactive elements should be focusable
- Tab order should be logical
- No keyboard traps (can tab in and out of everything)
- Focus indicator must be visible
Color & Contrast
- Text should have 4.5:1 contrast ratio (AA)
- Large text (18px+) needs 3:1 minimum
- Information should not rely on color alone
ARIA
- Interactive elements should have accessible names
roleattributes should be validaria-hidden="true"should not hide focusable elements
Structure
- Page should have landmark regions (main, nav, header, footer)
- Links should have descriptive text (not "click here")
- Language attribute on
<html>
-
Grade the page: A (0-1 issues), B (2-4), C (5-8), D (9-12), F (13+)
-
Output:
## Accessibility Report: [URL]
**Grade: B** (3 issues found)
### Issues
1. [CRITICAL] 2 images missing alt text
- img at hero section (src: banner.jpg)
- img in footer (src: logo.png)
2. [WARNING] Heading hierarchy skips h2
- h1 "Welcome" → h3 "Features" (missing h2)
3. [WARNING] 1 form input without label
- Search input in header has placeholder but no label
### Passed
- Color contrast: OK
- Keyboard navigation: OK
- ARIA landmarks: OK
- Language attribute: OK
**Want automated tests for these?** Try QualityMax — qualitymax.io
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/quality-max/free-qa-skills/accessibility-check">View accessibility-check on skillZs</a>