Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Automatyzacja

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.

Repozytorium
ui-harness ↗
Licencja
MIT
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. What This Catches
  2. No Nested Pressables
  3. Visual Checklist
Sekcje z nagłówków SKILL.md, w oryginale · 50 linii, 220 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.