accessibility-a11y — скилл для Claude Code
Скилл accessibility-a11y для Claude Code и Codex помогает внедрять стандарты WCAG 2.2 и проверять интерфейсы на доступность. Включается при создании UI-компонентов, аудите вёрстки или интеграции тестов в CI/CD.
MIT 161 установок ★ 114 обновлён 2026-11-10
npx skills add travisjneuman/.claude --skill accessibility-a11y -a claude-codeЧто делает accessibility-a11y
Скилл задаёт правила разработки доступных веб-интерфейсов по стандарту WCAG 2.2 на уровнях AA и AAA. Внутри описаны паттерны модальных диалогов, форм с валидацией ошибок, навигации с клавиатуры и динамических live regions.
Материал опирается на приоритет нативного семантического HTML над ARIA, управление фокусом и поддержку скринридеров VoiceOver и NVDA. Таблица контрастности даёт точные коэффициенты: 4.5:1 для обычного текста и 3:1 для крупных шрифтов и графики в WCAG AA.
Автоматические тесты выявляют только около 30% проблем доступности, поэтому скилл требует ручной проверки навигации с клавиатуры.
Какие задачи решает
- проверить компоненты на соответствие стандартам WCAG 2.2 AA и AAA
- настроить управление фокусом и навигацию с клавиатуры для модальных окон
- рассчитать минимальный контраст цветов для текста и элементов управления
- встроить проверки a11y в пайплайны CI/CD
Примеры запросов агенту
- Проверь форму оформления заказа на соответствие стандарту WCAG 2.2 AA
- Добавь правильные ARIA-атрибуты и ловушку фокуса для модального окна
- Проверь контрастность кнопок и полей ввода по таблице WCAG
Как установить accessibility-a11y
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill accessibility-a11y -a claude-code2Вручную: положить файлы
~/.claude/skills/accessibility-a11y/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/accessibility-a11y/
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill accessibility-a11y -a codex2Вручную: положить файлы
.agents/skills/accessibility-a11y/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill accessibility-a11y -a cursor2Вручную: положить файлы
.cursor/skills/accessibility-a11y/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/accessibility-a11y2Вручную: положить файлы
.github/skills/accessibility-a11y/SKILL.md1Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill accessibility-a11y -a gemini-cli2Командой платформы
gemini skills install https://github.com/travisjneuman/.claude --path skills/accessibility-a11yВручную: положить файлы
.devin/skills/accessibility-a11y/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill accessibility-a11y -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об accessibility-a11y
Как установить accessibility-a11y в Claude Code?
Выполните в терминале команду npx skills add travisjneuman/.claude --skill accessibility-a11y -a claude-code.
Что делает accessibility-a11y?
Направляет агента при разработке доступных интерфейсов по WCAG 2.2, предлагая ARIA-паттерны, правила контрастности и структуру семантического HTML.
Какие темы раскрывают справочные файлы скилла?
Справочники содержат решения для диалоговых окон и форм, краткую справку по ARIA, антипаттерны и чек-лист для проверки интерфейса.
Исходный текст
SKILL.md · MIT
--- name: accessibility-a11y description: WCAG 2.2 compliance, ARIA patterns, keyboard navigation, screen readers, automated testing --- # Accessibility (a11y) ## Overview This skill covers building accessible web applications that work for everyone, including people using screen readers, keyboard-only navigation, switch devices, and other assistive technologies. It addresses WCAG 2.2 compliance at AA and AAA levels, correct ARIA usage, focus management, color contrast, reduced motion support, and automated testing integration. Use this skill when building new UI components, reviewing existing interfaces for accessibility compliance, fixing a11y audit findings, or integrating automated accessibility testing into CI/CD pipelines. --- ## Core Principles 1. **Semantic HTML first** - Native HTML elements (`<button>`, `<nav>`, `<dialog>`) provide accessibility for free. ARIA is a repair tool for when semantics are insufficient, not a replacement for proper HTML. 2. **Keyboard is the baseline** - If it doesn't work with a keyboard alone, it doesn't work. Every interactive element must be focusable, operable, and have visible focus indicators. 3. **Test with real assistive technology** - Automated tools catch ~30% of accessibility issues. The rest require manual testing with screen readers (VoiceOver, NVDA) and keyboard-only navigation. 4. **Progressive enhancement** - Build the accessible version first, then layer on visual enhancements. Never hide content from assistive technology that sighted users can see. 5. **No information by color alone** - Color can reinforce meaning but never be the sole indicator. Use icons, text labels, and patterns alongside color. --- ## Reference files Detailed material is in separate files so this overview stays short. Read only the file whose topic matches the task; each one is self-contained. Paths are relative to the folder that holds this `SKILL.md` (in the full toolkit install, `~/.claude/skills/accessibility-a11y/`). | Topic | File | Covers | | --- | --- | --- | | Key Patterns | [`references/key-patterns.md`](references/key-patterns.md) | Pattern 1: Accessible Modal Dialog; Pattern 2: Accessible Form with Error Handling; Pattern 3: Keyboard Navigation for Custom Widgets; Pattern 4: Live Regions for Dynamic Content; Pattern 5: Automated Accessibility Testing | | ARIA Quick Reference | [`references/aria-quick-reference.md`](references/aria-quick-reference.md) | 13 lines | | Anti-Patterns | [`references/anti-patterns.md`](references/anti-patterns.md) | 14 lines | | Checklist | [`references/checklist.md`](references/checklist.md) | 17 lines | ## Color Contrast Quick Reference | Text Size | WCAG AA | WCAG AAA | |---|---|---| | Normal text (< 18px / 14px bold) | 4.5:1 | 7:1 | | Large text (>= 18px / 14px bold) | 3:1 | 4.5:1 | | UI components & graphical objects | 3:1 | 3:1 | | Decorative / disabled elements | No requirement | No requirement | --- ## Related Resources - **Skills:** `performance-engineering` (intersection of performance and a11y), `growth-engineering` (accessible onboarding) - **Rules:** `docs/reference/checklists/ui-visual-changes.md` (visual change accessibility checks) - **Rules:** `docs/reference/stacks/react-typescript.md` (React component patterns)
© travisjneuman · MIT · travisjneuman/.claude