/run-audit

/run-audit - Run Accessibility Audit

Execute a comprehensive accessibility audit against WCAG guidelines.

Steps

1. Ask the user for the target URL or component to audit 2. Configure the audit scope: WCAG 2.1 Level A, AA, or AAA 3. Run automated accessibility scanning using axe-core or similar engine 4. Check all WCAG success criteria applicable to the content type 5. Test keyboard navigation: all interactive elements reachable and operable 6. Verify focus management: visible focus indicators, logical focus order 7. Check ARIA usage: proper roles, states, properties, and landmark regions 8. Validate heading hierarchy: logical order without skipping levels 9. Test color contrast ratios: 4.5:1 for normal text, 3:1 for large text 10. Check form accessibility: labels, error messages, required field indicators 11. Verify media accessibility: alt text, captions, audio descriptions 12. Compile findings into a prioritized report by impact level

Rules

• Test against WCAG 2.1 AA as the minimum standard
• Automated tools catch about 30% of issues; note that manual testing is also needed
• Prioritize issues by user impact: critical (blocks access), serious, moderate, minor
• Include WCAG success criterion reference for each finding
• Test with actual assistive technology when possible (VoiceOver, NVDA)
• Do not flag decorative images that correctly have empty alt attributes
• Include remediation guidance with each finding