gabelul/stitch-kit / skills/stitch-a11y
stitch-a11y
VerifiedAudits Stitch-generated components for WCAG 2.1 AA accessibility issues and applies fixes β semantic HTML, ARIA attributes, keyboard navigation, focus management, and screen reader support.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.4 KB |
| resources/audit-checklist.md | markdown | 3.5 KB |
resources/audit-checklist.md
View on GitHub# Accessibility Pre-Ship Checklist
Quick reference before every production deployment.
Target: **WCAG 2.1 AA**.
---
## π Semantic HTML
- [ ] Page has exactly one `<main>` landmark
- [ ] Navigation uses `<nav aria-label="...">` (label required when multiple navs exist)
- [ ] `<header>`, `<footer>`, `<aside>` used for landmark regions
- [ ] Heading hierarchy is sequential β no skipped levels (e.g., h1 β h3 without h2)
- [ ] Lists use `<ul>` / `<ol>` + `<li>`, not `<div>` + `<div>`
- [ ] Tables have `<caption>` and `<th scope="col/row">` headers
- [ ] Forms use `<label for="id">` or `aria-label` on every input
---
## π· ARIA
- [ ] No `role="button"` on a real `<button>` (redundant)
- [ ] No ARIA used where semantic HTML already conveys the meaning
- [ ] Every `aria-labelledby` and `aria-describedby` references a real ID that exists
- [ ] Disclosure widgets (accordion, dropdown) have `aria-expanded` on the trigger
- [ ] Modal dialogs have `role="dialog"`, `aria-modal="true"`, `aria-labelledby`
- [ ] Loading/status updates use `aria-live="polite"` or `aria-live="assertive"`
- [ ] Icon-only interactive elements have `aria-label`
- [ ] Decorative images have `alt=""` and `aria-hidden="true"`
---
## β¨οΈ Keyboard navigation
- [ ] Tab order follows visual reading order (no `tabIndex={1}` or higher)
- [ ] All interactive elements are reachable by Tab
- [ ] Modals: focus moves into modal on open, returns to trigger on close
- [ ] Dropdowns: Escape closes and returns focus to trigger
- [ ] Custom interactive elements: Enter / Space activates them
- [ ] No keyboard traps (except intentional modal focus traps)
- [ ] Skip link is present and works (first focusable element on page)
---
## π Focus visibility
- [ ] No `outline: none` or `outline: 0` without a visible custom focus indicator
- [ ] Focus ring is visible in both light and dark mode
- [ ] Focus ring has sufficient contrast against all backgrounds it appears on
- [ ] `:focus-visible` used (not `:focus`) to avoid showing ring on mouse click
---
## πΌ Images & media
- [ ] All `<img>` / `<Image>` have `alt` attribute
- [ ] Meaningful images have descriptive alt text
- [ ] Decorative images have `alt=""`
- [ ] Videos have captions or transcripts
- [ ] Audio has transcripts
---
## π¨ Color & contrast
- [ ] Body text on background β₯ 4.5:1 contrast ratio
- [ ] Large text (18px+ regular or 14px+ bold) on background β₯ 3:1
- [ ] Interactive element boundaries visible against adjacent colors (β₯ 3:1)
- [ ] Errors not indicated by color alone β also include icon or text
- [ ] Required fields not indicated by color alone β include `(required)` text or aria
---
## π¬ Motion
- [ ] `@media (prefers-reduced-motion: reduce)` override in global CSS
- [ ] No autoplay video longer than 5 seconds (or provide pause control)
- [ ] No content that flashes more than 3 times per second
---
## π§ͺ How to test
**Keyboard only:**
1. Unplug/disable mouse
2. Tab through the entire page
3. Verify every action is reachable and operable
**Screen reader:**
- macOS: VoiceOver (Cmd+F5) + Safari
- Windows: NVDA (free) + Chrome
- iOS: VoiceOver + Safari
- Android: TalkBack + Chrome
**Automated:**
- axe DevTools browser extension (free tier covers ~30% of WCAG issues)
- Lighthouse β Accessibility panel
- `npx axe-cli http://localhost:3000` for CI
**Contrast:**
- browser-native: Chrome DevTools β Elements β Accessibility tab β contrast ratio
- WebAIM Contrast Checker: https://webaim.org/resources/contrastchecker/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |