setup-accessibility
/setup-accessibility
Wymusza dostępność ARIA przez hooki PostToolUse: etykiety, obsługę klawiatury i atrybuty widżetów oraz testy AXE w Playwright dla WCAG 2.1 AA.
- Autor
- redpanda-data ↗
- Repozytorium
- ui-harness ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 24.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 2
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/_hook-lib.sh, scripts/accessibility-check.sh
Co robi i kiedy
Wymusza dostępność ARIA przez hooki PostToolUse: etykiety, obsługę klawiatury i atrybuty widżetów oraz testy AXE w Playwright dla WCAG 2.1 AA.
Oryginalny opis (EN)
Enforce ARIA accessibility via PostToolUse hooks -- labels, keyboard handlers, widget attributes, Playwright AXE setup. Use when setting up a11y enforcement, WCAG 2.1 AA compliance, or accessibility testing.
Jak działa
- What This Catches
- No Nested Pressables
- Visual Checklist
Podgląd SKILL.md
---
name: setup-accessibility
description: Enforce ARIA accessibility via PostToolUse hooks -- labels, keyboard handlers, widget attributes, Playwright AXE setup. Use when setting up a11y enforcement, WCAG 2.1 AA compliance, or accessibility testing.
paths:
- "src/components/**/*.tsx"
---
# Accessibility Enforcement
## What This Catches
- **`<img>` without `alt`** -- use `alt=""` for decorative img
- **Mouse-only `onClick` on `<div>`/`<span>`** -- needs `role` + `tabIndex` + `onKeyDown`/`onKeyUp`
- **Missing ARIA on widget roles** -- `role="combobox"` needs `aria-expanded` + `aria-controls`, `role="dialog"` needs `aria-label`/`aria-labelledby`, `role="tablist"` needs child `role="tab"`
Escape hatch: `// allow: a11y-skip [reason]`
## No Nested Pressables
Interactive components ONE pattern -- never both:
**Pattern A: Container clickable** -- no interactive children.
```tsx
<ListCard onClick={handleSelect}>
<Avatar src={user.avatar} />
<Text>{user.name}</Text>
<ChevronRightIcon /> {/* visual indicator only, not a button */}
</ListCard>
```
**Pattern B: Children interactive** -- container not clickable.
```tsx
<ListCard>
<Avatar src={user.avatar} />
<Text>{user.name}</Text>
<DropdownMenu>
<DropdownMenuTrigger asChild>
<Button variant="ghost" size="icon"><MoreVerticalIcon /></Button>
</DropdownMenuTrigger>
</DropdownMenu>
</ListCard>
```
Why: ambiguous click targets, event bubbling bugs, screen readers can't convey interaction model, touch targets overlap on mobile.
## Visual Checklist
- [ ] Focus rings visible on all interactive elements (min 2px, contrasting color)
- [ ] Hover and focus styles match (no mouse-only affordances)
- [ ] Color not sole means of conveying info
- [ ] Touch targets min 44x44 CSS pixels
- [ ] `prefers-reduced-motion` respected for animations
- [ ] `forced-colors` / high-contrast mode: use `currentcolor` for SVG fills
- [ ] Text resizable to 200% without content loss
Initial setup (install, AXE fixture, hook config): see [SETUP.md](SETUP.md).
Pliki w paczce (4)
- SETUP.md 3 KB
- SKILL.md 2 KB
- scripts/_hook-lib.sh 1 KB
- scripts/accessibility-check.sh 4 KB
Wersje
W bazie nie ma innych skilli o nazwie setup-accessibility.
Migawka bazy z 13.11.2026 · wersja paczki 5ef4b52d519f (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 98audit-accessibility
Sprawdza zgodność strony z WCAG 2.2 AA przez playwright-cli: axe-core, nawigację klawiaturą, kontrast, rozmiar celów dotyku, fokus i atrybuty ARIA. - 90axe-fix
Pisze poprawki dostępności dla konkretnych niezgodności z WCAG: ARIA, zarządzanie fokusem i wzorce obsługi klawiatury. - 100a11y-playwright-testing
Pisze, uruchamia i debuguje testy dostępności aplikacji webowych w Playwright, TypeScript i axe-core: WCAG 2.2 AA, klawiatura, fokus, ARIA, etykiety formularzy i kontrast. - 100audit-accessibility
Audytuje dostępność komponentów łącznie: analiza statyczna, testy w czasie działania (axe), wzorce ARIA, nawigacja klawiaturą, zarządzanie fokusem i kontrast kolorów zgodnie z WCAG. - 95web-accessibility
Wdraża dostępność WCAG 2.1 AA w interfejsie: atrybuty ARIA, nawigację klawiaturą, semantykę HTML i zarządzanie fokusem. - 100accessibility-testing
Testuje zgodność z WCAG 2.2 AA narzędziem axe-core i Playwright, audyt nawigacji klawiaturą, testy czytnika ekranu i wzorce ARIA.