A11y Audit

Audyt WCAG 2.2 AA/AAA z zmierzonymi współczynnikami kontrastu i poprawkami odwołującymi się do kryteriów

Autor: plugin87 · plugin87/ux-ui-agent-skills

Testowano · Działa ★ 8.4/10

A11y Audit — Audyt WCAG 2.2 AA/AAA z zmierzonymi współczynnikami kontrastu i poprawkami odwołującymi się do kryteriów

Co robi ten skill

Audytuje interfejs użytkownika lub komponent pod kątem WCAG 2.2 AA/AAA i wzorców WAI-ARIA, zwracając tabelę wyników przypisanych do konkretnych kryteriów sukcesu z poziomem ważności P0/P1/P2 i konkretnymi poprawkami. Uruchamia się, gdy użytkownik prosi o sprawdzenie dostępności, weryfikację kontrastu lub przegląd klawiatury/czytnika ekranu. Odczytuje listę kontrolną zorganizowaną według POUR i odniesienie ARIA oraz mierzy kontrast kolorów za pomocą dołączonego skryptu, zamiast oceniać proporcje wizualnie.

Raport z testu

Pobrano SKILL.md i sprawdzono 6 odwołanych ścieżek przez raw fetch — wszystkie HTTP 200; wcag-checklist.md i aria-patterns.md to obszerne, rzeczywiste odniesienia (tabela kryteriów zorganizowana według POUR, mapy klawiatury ARIA APG). Uruchomiono scripts/contrast.py (czysty python3, bez zależności): #767676/#fff = 4.54:1 PASS, #999/#fff = 2.85:1 FAIL, kody wyjścia poprawne. Do testu wyjścia napisałem 6-elementowy card.html i poddałem go audytowi na dwa sposoby: wizualny audyt bazowy vs treść umiejętności, która nakazuje uruchamianie contrast.py dla każdej pary. Zmierzone proporcje zmieniły dwie wizualne oceny — niebieski link #5b8def wygląda dobrze, ale mierzy 3.23:1 (FAIL 1.4.3), a czerwona plakietka #d32f2f wygląda słabo, ale mierzy 4.98:1 (PASS); nagłówek #8a8a8a = 3.45:1 i tekst #a0a0a0 = 2.61:1 oba FAIL. Brak zagrożeń bezpieczeństwa (brak curl|sh, base64, eval). Tarcie: katalog umiejętności zawiera tylko SKILL.md i zależy od plików/skryptów rodzeństwa w katalogu głównym repozytorium, więc samodzielna kopia katalogu umiejętności psuje jej kroki — wymagana jest pełna instalacja pakietu.

Testowano: 2026-07-21 · Claude Code 2.x (agent harness)

Instalacja

git clone --depth 1 https://github.com/plugin87/ux-ui-agent-skills.git /tmp/a11y-audit-src
mkdir -p ~/.claude/skills
cp -R /tmp/a11y-audit-src/.claude/skills/a11y-audit ~/.claude/skills/a11y-audit
# IMPORTANT: the skill dir holds only SKILL.md. Its steps read repo-root sibling files
#   accessibility/wcag-checklist.md, accessibility/aria-patterns.md, taste/motion-choreography.md
#   and run scripts/contrast.py, scripts/measure_render.mjs, scripts/verify_states.mjs
# — all relative to the repo root, NOT bundled with the skill. For full function, install the
# whole package into your project: npx ux-ui-agent-skills  (installs accessibility/ + scripts/ too).
# scripts/contrast.py = pure python3, no deps. measure_render.mjs/verify_states.mjs need:
#   npm i -D playwright   (without it they SKIP with exit 0, they do not error).

Komendy i przykładowe prompty

/a11y-auditAudyt WCAG 2.2 AA/AAA z zmierzonymi współczynnikami kontrastu i poprawkami odwołującymi się do kryteriów

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

Audit this page for WCAG 2.2 AA compliance
Check the contrast ratios on this design
Review this component for screen-reader support

Pełny raport →