Get the FREE Ultimate OpenClaw Setup Guide →

accessibility-audit

Scanned
npx machina-cli add skill gologo13/agent-skills/accessibility-audit --openclaw
Files (1)
SKILL.md
1.8 KB

Accessibility Audit

Overview

Perform comprehensive accessibility (a11y) audit of the current UI code to ensure compliance with WCAG guidelines and provide an inclusive user experience.

Steps

  1. WCAG Compliance
    • Check conformance to WCAG 2.1 guidelines (A, AA, AAA levels)
    • Verify proper semantic HTML structure
    • Ensure keyboard navigation support
    • Review color contrast and visual accessibility
  2. Screen Reader Support
    • Validate ARIA labels and descriptions
    • Check heading hierarchy and structure
    • Ensure form labels and error messages are accessible
    • Review dynamic content announcements
  3. Interactive Elements
    • Verify focus management and visible focus indicators
    • Check tab order and keyboard shortcuts
    • Ensure interactive elements are properly sized
    • Review modal and dialog accessibility
  4. Testing & Tools
    • Suggest automated accessibility testing tools
    • Provide manual testing procedures
    • Create accessibility test cases
    • Recommend browser extensions and validators
  5. Remediation
    • Provide specific code fixes for each issue
    • Include ARIA attributes and semantic improvements
    • Suggest alternative approaches for complex interactions
    • Create accessible component patterns

Accessibility Audit Checklist

  • WCAG compliance verified
  • Screen reader support validated
  • Interactive elements accessible
  • Testing tools recommended
  • Remediation code provided with examples

Source

git clone https://github.com/gologo13/agent-skills/blob/main/skills/accessibility-audit/SKILL.mdView on GitHub

Overview

Perform a thorough audit of the current UI against WCAG 2.1 guidelines to ensure an inclusive user experience. It covers semantic HTML, keyboard navigation, color contrast, screen reader support, and dynamic content announcements, plus concrete remediation guidance.

How This Skill Works

The skill evaluates WCAG conformance, validates ARIA labels and heading structures, checks focus management and dialog accessibility, and combines automated tools with manual testing to produce actionable remediation steps and code fixes.

When to Use It

  • Before launching a new UI or feature to ensure WCAG 2.1 compliance.
  • After major UI changes or refactors that may affect accessibility.
  • When explicit accessibility requirements are requested by stakeholders (not for routine implementations).
  • During QA cycles to verify keyboard navigation, screen reader support, and focus management.
  • To generate concrete remediation guidance and accessible component patterns.

Quick Start

  1. Step 1: Review WCAG 2.1 conformance and verify semantic HTML structure.
  2. Step 2: Validate ARIA attributes, heading hierarchy, labels, and focus management.
  3. Step 3: Run automated accessibility tests, perform manual checks, and capture remediation steps with code examples.

Best Practices

  • Align audits with WCAG 2.1 A, AA, and AAA levels and verify semantic HTML structure.
  • Prioritize keyboard accessibility: ensure logical focus order, visible focus indicators, and usable shortcuts.
  • Validate ARIA attributes and screen reader announcements across components.
  • Combine automated tooling with thorough manual testing and real user scenarios.
  • Provide concrete code fixes, ARIA improvements, and accessible component patterns.

Example Use Cases

  • Audit a login flow for proper labels, focus management, and ARIA descriptions.
  • Review a modal/dialog to ensure focus traps and accurate screen reader announcements.
  • Check color contrast and scalable typography in a dashboard with charts and tables.
  • Verify form validation messages are accessible and announced by screen readers.
  • Evaluate dynamic content updates to ensure correct ARIA live region behavior.

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers