ux-ui-a11y_skill

Overview

This skill is an accessibility inspection agent that tests and helps improve web UI accessibility. It automates checks for WCAG conformance, keyboard and screen reader compatibility, and color contrast issues. The skill produces actionable accessibility reports and remediation suggestions. Outputs are organized for easy review and follow-up implementation.

How this skill works

The agent crawls specified pages or components and runs a set of automated audits against WCAG success criteria, keyboard navigation flows, ARIA usage, and color contrast thresholds. It simulates keyboard-only interaction and inspects semantic structure for screen reader compatibility, flagging likely problems and providing code-level recommendations. Results are written to a structured accessibility report that highlights severity, reproducibility steps, and remediation guidance.

When to use it

• Before release to validate WCAG compliance and reduce legal risk
• During UI development sprints to catch accessibility regressions early
• When onboarding a new design system or component library
• Prior to accessibility audits or external reviews
• To triage reported accessibility issues from users or QA

Best practices

• Run the agent early and often in CI to detect regressions before deployment
• Combine automated findings with manual testing (keyboard and screen reader)
• Prioritize fixes by impact and severity; focus on navigation and perceivability first
• Include design and product teams in remediation to ensure UX-consistent fixes
• Document resolved issues and update component tests to prevent recurrence

Example use cases

• Generate a sprint-end accessibility report for a public-facing marketing site
• Scan a component library for missing ARIA roles and keyboard traps
• Validate color contrast for a new theme before a major redesign
• Produce remediation steps for a login flow that fails screen reader tests
• Integrate into CI to block merges that introduce high-severity accessibility regressions