accessibility-auditor

$npx mdskill add OneWave-AI/claude-skills/accessibility-auditor

Audit websites for accessibility issues and WCAG compliance

  • Identifies and addresses website accessibility defects using automated tools and manual testing.
  • Depends on CLI scans, jest-axe, Playwright assertions, keyboard testing checklist, screen reader verification, and WCAG criteria references.
  • Decides based on automated results, manual tests, and WCAG guidelines to recommend fixes for common issues.
  • Delivers actionable recommendations in the form of fix patterns and ARIA markup solutions.

SKILL.md

.github/skills/accessibility-auditorView on GitHub ↗
---
name: accessibility-auditor
description: Audit websites for accessibility issues and WCAG compliance. Use when checking accessibility, fixing a11y issues, or ensuring WCAG compliance.
---

# Accessibility Auditor

Audit a website for accessibility defects and bring it to WCAG 2.1 AA compliance.

## Contents

- `references/automated-testing.md` - CLI commands, jest-axe, Playwright, and tooling
- `references/wcag-checklist.md` - WCAG Level A/AA criteria and keyboard testing checklist
- `references/common-fixes.md` - Fix patterns for the 7 most common defects plus the sr-only class
- `references/aria-patterns.md` - ARIA markup for tabs, accordion, menu, alert, progress

## Workflow

1. Run automated checks. Execute the CLI scans and add jest-axe or Playwright assertions per `references/automated-testing.md`.
2. Test the keyboard. Tab through the page and verify order, activation, escape, focus visibility, and absence of traps using the checklist in `references/wcag-checklist.md`.
3. Test with a screen reader. Walk the page with NVDA or VoiceOver and confirm names, roles, and announced state.
4. Check WCAG criteria. Audit each Level A and AA criterion in `references/wcag-checklist.md`.
5. Apply fixes. Resolve each finding with the patterns in `references/common-fixes.md` and `references/aria-patterns.md`, then re-run step 1 to confirm zero violations.

More from OneWave-AI/claude-skills

SkillDescription
agent-armyDeploy a 2-layer parallel agent hierarchy for large, parallelizable work — big refactors, multi-file migrations, codebase-wide audits, bulk generation. Layer 1 is 3-50+ specialist agents, each with its own full context window; Layer 2 is 2+ sub-agents per member. Includes git safety, tiered sizing, a pre-deploy gate, phantom-completion checks, and multi-wave follow-up.
agent-swarm-deployerDeploys swarms of sub-agents for massive parallel data processing tasks. Unlike agent-army (which is for code changes), this is for DATA tasks -- processing 1000 documents, analyzing datasets, bulk content generation. Configurable swarm size, task distribution, result aggregation, progress tracking, and error recovery.
agent-team-builderDesigns and deploys custom agent teams for specific business workflows. Interactive discovery of business processes, then generates complete team configurations with specialized agent roles, tool access, communication protocols, and handoff rules.
agent-to-agentAgent-to-Agent (A2A) communication protocol. Connect two or more Claude agents that pass messages, share context, delegate tasks, and collaborate. Implements structured handoffs, shared memory, and multi-agent conversations.
ai-readiness-assessmentAssesses how ready a business is for AI adoption across six dimensions. Evaluates data maturity, tech stack, team skills, process documentation, budget, and culture. Generates a comprehensive ai-readiness-report.md with scores, gap analysis, and recommended starting points. Aligned with OneWave AI's audit methodology.
api-documentation-writerGenerate comprehensive API documentation including endpoint descriptions, request/response examples, authentication guides, error codes, and SDKs. Creates OpenAPI/Swagger specs, REST API docs, and developer-friendly reference materials. Use when users need to document APIs, create technical references, or write developer documentation.
api-endpoint-scaffolderGenerate REST API endpoints with proper structure, validation, error handling, and types. Use when creating new API routes, endpoints, or backend services.
api-load-testerLoad tests API endpoints with progressive concurrency. Measures response times, error rates, throughput, and identifies breaking points. Generates a detailed report with latency percentiles, throughput curves, bottleneck analysis, and optimization recommendations.
athlete-social-media-managerCreate brand-safe content for athletes. Personal branding strategy, engagement optimization, crisis communication, sponsor integration.
board-deck-generatorGenerates professional board meeting presentation content (board-deck.md) with executive summary, financials, product updates, GTM metrics, team/hiring, strategic decisions, and appendix. Supports early-stage, growth-stage, and pre-IPO formats. Use when preparing board meeting materials, quarterly board updates, or investor presentations.