review-accessibility

What problem does it solve?

The repository's UI can exclude keyboard and screen reader users, mobile touch users, and people with low vision due to missing labels, small touch targets, absent ARIA attributes, poor contrast, and unannounced dynamic updates. This Skill provides a structured review to find, document, and prioritize those accessibility regressions so they can be fixed systematically and verified against WCAG 2.1 AA criteria.

Core Features & Use Cases

• Touch target verification: Calculate rendered sizes for icon buttons and interactive controls and recommend min-h-11/min-w-11 or increased padding to meet WCAG 2.5.5.
• Label and ARIA audits: Ensure inputs have programmatic labels, icon-only buttons have aria-label, decorative icons are aria-hidden, and dynamic regions use aria-live where appropriate (WCAG 4.1.2).
• Alt text and image semantics: Identify missing or non-descriptive alt attributes and mark decorative imagery as presentational.
• Keyboard and focus behavior checks: Detect non-button clickable divs, missing tab stops, focus traps, and removed focus indicators without accessible replacements.
• Contrast estimation: Flag low-contrast text and opacity variants that fail 1.4.3 and recommend accessible color alternatives or increased weight/size.
• Screen reader behavior: Verify announcements for live updates, contextual labeling for counts (e.g., "47 upvotes"), and proper list semantics for nested comments.
• Use Case: Run this pass on the Cebu Airsoft Hub to produce docs/code-review/pass-5-accessibility.md with file_path:line_number findings, prioritized fixes, and WCAG references.

Quick Start

Run a Pass 5 accessibility audit on the repository and produce docs/code-review/pass-5-accessibility.md containing file_path:line_number findings, impact ratings, and prioritized fixes.