Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Przegląd i audyt

superior-accessibility

/superior-accessibility

Sprawdza i wdraża dostępność interfejsu: semantykę, obsługę klawiaturą, fokus, kontrast i komunikaty dla czytników ekranu.

Licencja
MIT
Ostatnia zmiana repozytorium
26.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
3
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.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ą
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/contrast_check.py

Co robi i kiedy

Sprawdza i wdraża dostępność interfejsu: semantykę, obsługę klawiaturą, fokus, kontrast i komunikaty dla czytników ekranu.

Oryginalny opis (EN)

Review or implement interface accessibility for semantics, keyboard operation, focus, contrast, status communication, zoom, and assistive technology. Use when accessibility is explicitly requested, required by the product contract, or a changed interaction creates substantial accessibility risk. Do not activate for every visual edit or use it as a generic design audit.

Jak działa

  1. Structure and names
  2. Keyboard and focus
  3. Contrast and non-color cues
  4. Dynamic states
  5. Zoom, motion, and touch
  6. Verify behavior
Sekcje z nagłówków SKILL.md, w oryginale · 62 linii, 539 słów
Podgląd SKILL.md
---
name: superior-accessibility
description: Review or implement interface accessibility for semantics, keyboard operation, focus, contrast, status communication, zoom, and assistive technology. Use when accessibility is explicitly requested, required by the product contract, or a changed interaction creates substantial accessibility risk. Do not activate for every visual edit or use it as a generic design audit.
---

# Superior Accessibility

Preserve the user's ability to perceive, understand, navigate, and operate the changed interface. Prefer native semantics and observable behavior over ARIA-heavy patches.

Establish the affected journey, interaction model, supported platform, and available verification tools before choosing a fix. Preserve product behavior unless an inaccessible interaction contract must change.

## Structure and names

- Use the native element whose behavior matches the control.
- Give controls an accessible name that matches or includes the visible label.
- Keep heading order, landmarks, lists, tables, and form relationships meaningful.
- Use alternative text for informative images; keep decorative imagery out of the accessibility tree.
- Add ARIA only when native HTML cannot express the necessary relationship or state, and keep it synchronized.

## Keyboard and focus

- Make every essential action reachable and operable without a pointer.
- Preserve a logical focus order that matches the reading and interaction sequence.
- Show a visible focus indicator against every surface it crosses.
- Move focus only for a real context change such as opening a modal; restore it when that context closes.
- Ensure overlays trap focus when appropriate, close predictably, and do not leave background content interactive.

## Contrast and non-color cues

Use `scripts/contrast_check.py` for known solid sRGB colors when Python is available:

```text
python scripts/contrast_check.py "#1f2937" "#ffffff"
```

Resolve the script relative to this `SKILL.md`. For gradients, images, opacity, filters, or compositing, inspect the actual rendered result; two source hex values may not represent the final contrast.

- Target at least 4.5:1 for normal text and 3:1 for large text under WCAG 2.x.
- Check meaningful component boundaries and focus indicators against adjacent colors.
- Pair color with text, iconography, shape, or another cue for status and validation.
- Do not assume muted text is exempt because it is secondary.

## Dynamic states

- Expose validation errors near their fields and summarize them when the form needs it.
- Announce important asynchronous results without repeatedly interrupting the user.
- Keep loading, expanded, selected, pressed, checked, current, invalid, and disabled states programmatically accurate.
- Do not disable an action without explaining the prerequisite when it is not otherwise obvious.

Read [references/interaction-and-assistive-technology.md](references/interaction-and-assistive-technology.md) when the task includes dialogs, composite widgets, custom controls, drag and drop, live updates, route changes, virtualized content, or screen-reader-specific behavior.

## Zoom, motion, and touch

- Reflow at supported zoom without losing information or actions.
- Keep focused inputs visible above virtual keyboards and fixed UI.
- Provide comfortable touch targets and spacing.
- Respect reduced-motion preferences and avoid motion that is required to understand the result.

## Verify behavior

Use keyboard-only navigation through the changed journey. Inspect accessible names and states with available platform tools, test relevant zoom and narrow layouts, and check contrast at the rendered colors. Automated checks are useful coverage, not proof of usability; report both automated and manual evidence.

Do not claim screen-reader compatibility without naming the browser, assistive technology, platform, and journey actually exercised. When that environment is unavailable, verify semantics and accessibility-tree output where possible, then report the untested combination explicitly.

Use `superior-code-review` when accessibility is only one risk area in a broader change-set review, `superior-responsive` for space-driven re-composition, and `superior-ui` for visual or interaction implementation outside the accessibility contract.
Pliki w paczce (3)
  • SKILL.md 4 KB
  • references/interaction-and-assistive-technology.md 3 KB
  • scripts/contrast_check.py 2 KB

Wersje

W bazie nie ma innych skilli o nazwie superior-accessibility.

Migawka bazy z 13.11.2026 · wersja paczki f823280cf4a6 (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

  • 90dev-accessibility-audit
    Audytuje dostępność stron i aplikacji: semantykę, nawigację klawiaturą, fokus, etykiety, ARIA, kontrast i responsywność.
  • 100accessibility-auditor
    Sprawdza interfejs pod kątem dostępności: WCAG 2.2 AA, nawigację klawiaturą, fokus, ARIA, kontrast i semantykę dla czytników ekranu.
  • 90fixing-accessibility
    Audytuje, naprawia lub weryfikuje dostępność interfejsu: semantykę, etykiety, klawiaturę, fokus, formularze, kontrast i ruch.
  • 90fixing-accessibility
    Audytuje, naprawia lub weryfikuje dostępność interfejsu: semantykę, etykiety, klawiaturę, fokus, formularze, kontrast i ruch.
  • 100accessibility
    Sprawdza i poprawia dostępność aplikacji Flutter: etykiety dla czytników ekranu, rozmiary celów dotyku i kontrast.
  • 100rachnasutra-access
    Przegląda dostępność interfejsu według WCAG 2.2 AA: semantykę, nazwy, klawiaturę, fokus, kontrast i formularze.

Uwagi i zgłoszenia

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