К основному содержанию
скилл CX Codex

accessibility · yonatangross — скилл для Claude Code: доступность и установка

Скилл accessibility для Claude Code помогает добавлять доступность в веб-интерфейсы. Активируется при работе с клавиатурной навигацией, экранными дикторами и ARIA-компонентами.

MIT 246 установок ★ 305 обновлён 2026-11-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yonatangross/orchestkit --skill accessibility -a claude-code
Открыть на GitHub

Что делает accessibility

Скилл даёт правила для разработки доступных веб-интерфейсов по WCAG 2.2 AA. В них разбираются семантическая HTML-разметка, контраст, подписи форм, управление фокусом и предпочтения пользователя, включая уменьшение анимации.

В наборе 10 правил по шести категориям: от клавиатурной навигации до React Aria и проверок доступности. Отдельные файлы правил загружаются по запросу. Для тестирования описаны axe-core и Playwright; при работе в Claude Code нужна версия 2.1.277 или новее.

Какие задачи решает

  • добавить клавиатурную навигацию в интерактивные компоненты
  • настроить управление фокусом в диалогах
  • проверить семантическую разметку и подписи форм
  • учесть предпочтение пользователя к уменьшению анимации

Примеры запросов агенту

  • Добавь поддержку экранного диктора и проверь разметку этой формы.
  • Настрой клавиатурную навигацию и управление фокусом в диалоге.
  • Проверь компонент на соответствие рекомендациям WCAG 2.2 AA.

Как установить accessibility

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill accessibility -a claude-code

2Вручную: положить файлы

~/.claude/skills/accessibility/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/accessibility/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об accessibility

Как установить accessibility в Claude Code?

Выполни npx skills add yonatangross/orchestkit --skill accessibility -a claude-code. Файл скилла появится по пути ~/.claude/skills/accessibility/SKILL.md.

Что делает accessibility?

Скилл содержит правила для доступных веб-интерфейсов: семантическая HTML-разметка, контраст, клавиатурная навигация, управление фокусом и React Aria.

Какая версия Claude Code нужна для accessibility?

Для Claude Code нужна версия 2.1.277 или новее.

Исходный текст

SKILL.md · MIT
---
name: accessibility
license: MIT
compatibility: "Claude Code 2.1.277+."
description: "WCAG 2.2 accessibility patterns: keyboard focus management, React Aria, cognitive inclusion, native HTML-first. Use when implementing screen reader support, keyboard navigation, ARIA patterns, focus traps, accessible components, or reduced motion."
user-invocable: false
metadata:
  archive-candidate: "pending an outside usage signal"
  owner-agent: "accessibility-specialist"
  category: document-asset-creation
  version: "2.1.0"
  author: "OrchestKit"
  complexity: "medium"
  tags: "accessibility, a11y, wcag, focus-management, react-aria, keyboard-navigation, screen-reader, aria"
allowed-tools: "Read Glob Grep WebFetch WebSearch"
---

# Accessibility

Comprehensive patterns for building accessible web applications: WCAG 2.2 AA compliance, keyboard focus management, React Aria component patterns, native HTML-first philosophy, cognitive inclusion, and user preference honoring. Each category has individual rule files in `rules/` loaded on-demand.

## Quick Reference

| Category | Rules | Impact | When to Use |
|----------|-------|--------|-------------|
| [WCAG Compliance](#wcag-compliance) | 3 | CRITICAL | Color contrast, semantic HTML, automated testing |
| [POUR Exit Criteria](#pour-exit-criteria) | 1 | CRITICAL | Falsifiable pass/fail thresholds for each WCAG 2.2 AA criterion |
| [Static Anti-Patterns](#static-anti-patterns) | 1 | HIGH | Grep-able patterns detectable without a browser |
| [Focus Management](#focus-management) | 1 | HIGH | Keyboard navigation; trap/restoration mechanics live upstream |
| [React Aria](#react-aria) | 2 | HIGH | Accessible components and form hooks; overlay APIs live upstream |
| [Modern Web Accessibility](#modern-web-accessibility) | 2 | CRITICAL/HIGH | Native HTML first, user preferences; cognitive ceilings in `references/ork-delta.md` |

**Total: 10 rules across 6 categories**

## Quick Start

```tsx
// Semantic HTML with ARIA
<main>
  <article>
    <header><h1>Page Title</h1></header>
    <section aria-labelledby="features-heading">
      <h2 id="features-heading">Features</h2>
    </section>
  </article>
</main>
```

```tsx
// Focus trap with React Aria
import { FocusScope } from 'react-aria';

<FocusScope contain restoreFocus autoFocus>
  <div role="dialog" aria-modal="true">
    {children}
  </div>
</FocusScope>
```

## WCAG Compliance

WCAG 2.2 AA implementation for inclusive, legally compliant web applications.

| Rule | File | Key Pattern |
|------|------|-------------|
| Color Contrast | `rules/wcag-color-contrast.md` | 4.5:1 text, 3:1 UI components, focus indicators |
| Semantic HTML | `rules/wcag-semantic-html.md` | Landmarks, headings, ARIA labels, form structure |
| Testing | `rules/wcag-testing.md` | axe-core, Playwright a11y, screen reader testing |

## POUR Exit Criteria

Concrete pass/fail thresholds for each WCAG 2.2 AA criterion — replaces vague "meets requirements" checks.

| Rule | File | Key Pattern |
|------|------|-------------|
| POUR Exit Criteria | `rules/pour-exit-criteria.md` | Falsifiable checklist: image alt, contrast ratios, focus indicators, touch targets, ARIA states |

## Static Anti-Patterns

Grep-able anti-patterns detectable via static analysis or code review — no browser needed.

| Rule | File | Key Pattern |
|------|------|-------------|
| A11y Anti-Patterns (Static) | `rules/a11y-antipatterns-static.md` | Focus removal, missing labels, autoplay, icon-only buttons, div-click handlers |

## Focus Management

Keyboard focus management patterns for accessible interactive widgets.

| Rule | File | Key Pattern |
|------|------|-------------|
| Keyboard Navigation | `rules/focus-keyboard-nav.md` | Roving tabindex, skip links, arrow keys |

Focus trap and restoration mechanics are upstream's job: use React Aria `<FocusScope contain restoreFocus autoFocus>` (see [Upstream coverage](#upstream-coverage-do-not-restate)). When React Aria is unavailable, copy `scripts/focus-trap-template.tsx`; the house rules for both live in `references/ork-delta.md`.

## React Aria

Adobe React Aria hooks for building WCAG-compliant interactive UI.

| Rule | File | Key Pattern |
|------|------|-------------|
| Components | `rules/aria-components.md` | useButton, useDialog, useMenu, FocusScope |
| Forms | `rules/aria-forms.md` | useComboBox, useTextField, useListBox |

Overlay hook APIs (useModalOverlay, useTooltip, usePopover) are documented upstream (see [Upstream coverage](#upstream-coverage-do-not-restate)); the house overlay recipe (FocusScope plus shared motion presets) is in `references/ork-delta.md`.

## Modern Web Accessibility

2026 best practices: native HTML first, cognitive inclusion, and honoring user preferences.

| Rule | File | Key Pattern |
|------|------|-------------|
| Native HTML First | `rules/wcag-native-html-first.md` | `<dialog>`, `<details>`, native over custom ARIA |
| User Preferences | `rules/wcag-user-preferences.md` | prefers-reduced-motion, forced-colors, prefers-contrast, zoom |

Cognitive inclusion (ADHD/autism/dyslexia support) is covered upstream by W3C COGA (see [Upstream coverage](#upstream-coverage-do-not-restate)); the house cognitive-load ceilings (notification cap, nav-item cap, reading-level targets) are in `references/ork-delta.md`.

## Key Decisions

| Decision | Recommendation |
|----------|----------------|
| Conformance level | WCAG 2.2 AA (legal standard: ADA, Section 508) |
| Contrast ratio | 4.5:1 normal text, 3:1 large text and UI components |
| Target size | 24px min (WCAG 2.5.8), 44px for touch |
| Focus indicator | 3px solid outline, 3:1 contrast |
| Component library | React Aria hooks for control, react-aria-components for speed |
| State management | react-stately hooks (designed for a11y) |
| Focus management | FocusScope for modals, roving tabindex for widgets |
| Testing | jest-axe (unit) + Playwright axe-core (E2E) |

## Anti-Patterns (FORBIDDEN)

- **Div soup**: Using `<div>` instead of semantic elements (`<nav>`, `<main>`, `<article>`)
- **Color-only information**: Status indicated only by color without icon/text
- **Missing labels**: Form inputs without associated `<label>` or `aria-label`
- **Keyboard traps**: Focus that cannot escape without Escape key
- **Removing focus outline**: `outline: none` without replacement indicator
- **Positive tabindex**: Using `tabindex > 0` (disrupts natural order)
- **Div with onClick**: Using `<div onClick>` instead of `<button>` or `useButton`
- **Manual focus in modals**: Using `useEffect` + `ref.focus()` instead of `FocusScope`
- **Auto-playing media**: Audio/video that plays without user action
- **ARIA overuse**: Using ARIA when semantic HTML suffices

## Upstream coverage (do not restate)

Vendor tutorials, API references, and criterion walkthroughs removed in the 2026-07-31 wrap-plus-delta thinning. Consult the first-party source; only the ork delta (floors, scars, house decisions) lives in `references/ork-delta.md`.

| Topic | First-party source |
|-------|--------------------|
| WCAG 2.2 success-criterion walkthroughs and audit checklists | [WCAG 2.2 quick reference](https://www.w3.org/WAI/WCAG22/quickref/) and [WCAG 2.2 spec](https://www.w3.org/TR/WCAG22/) |
| ARIA widget patterns and keyboard interaction models | [WAI-ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/) |
| React Aria hook APIs (useButton, useMenu, useComboBox, useModalOverlay, useTooltip, usePopover), component checklists, worked examples | [React Aria docs](https://react-spectrum.adobe.com/react-aria/) |
| Focus trap, focus restoration, roving tabindex, and skip-link algorithms | [React Aria FocusScope](https://react-spectrum.adobe.com/react-aria/FocusScope.html) and [APG patterns](https://www.w3.org/WAI/ARIA/apg/patterns/) |
| Cognitive accessibility guidance (COGA) | [W3C Making Content Usable](https://www.w3.org/TR/coga-usable/) |
| Screen reader testing walkthroughs (NVDA, JAWS, VoiceOver, TalkBack) | [WebAIM screen reader testing](https://webaim.org/articles/screenreader_testing/) |

## Detailed Documentation

| Resource | Description |
|----------|-------------|
| `scripts/` | Templates: accessible form, focus trap, React Aria components |
| `references/ork-delta.md` | Ork-specific floors, scars, and house decisions (cognitive ceilings, overlay recipe, canonical focus-trap selector) |
| `references/ux-thresholds-quick.md` | UI/UX thresholds quick reference: contrast, touch targets, cognitive load, typography, forms |
| `examples/wcag-examples.md` | Complete accessible form, modal, and navigation examples |

## Related Skills

- `ork:testing-e2e` - E2E testing patterns including accessibility testing
- `design-system-starter` - Accessible component library patterns
- `ork-extras:i18n-date-patterns` - RTL layout and locale-aware formatting
- `motion-animation-patterns` - Reduced motion and animation accessibility

© OrchestKit · MIT · yonatangross/orchestkit

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — accessibility от других авторов.

accessibility web-quality-skills Скилл accessibility для Claude Code проводит аудит доступности веб-страницы и указывает, что исправить в исходниках. Закрывает WCAG 2.2, проверку клавиатуры и скринридера. CX Codex +1 72 600установок accessibility affaan-m Скилл accessibility для Claude Code помогает проектировать и проверять доступность интерфейсов по WCAG 2.2 Level AA. Включается при создании UI, аудите кода и работе с клавиатурой или скринридером. CX Codex +1 6 900установок accessibility oakoss Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров. CX Codex +1 164установок accessibility microsoft Скилл собирает ссылки на WCAG 2.2, ARIA APG, Section 508 и EN 301 549 и ведёт шестифазный процесс Accessibility Planner от разведки до передачи задач в бэклог. CX Codex +1 ★ 1 627звёзд репо accessibility Ivanna Kaceviča Скилл accessibility разбирает задачу по чек-листу WCAG — клавиатура, скринридер, контраст, формы — и находит конкретные нарушения доступности. Включается по словам a11y, ARIA, alt text, focus order, contrast. CX Codex +1 ★ 674звёзд репо web-accessibility akillness Скилл web-accessibility классифицирует дефекты доступности веб-интерфейса, отсекает лишний ARIA-код и формирует чёткий план доработок с ручной проверкой. CX Codex +1 558установок fixing-accessibility ibelick Скилл fixing-accessibility для Claude Code проверяет HTML на проблемы доступности и предлагает точечные исправления. Проверяет формы, диалоги и интерактивные элементы. CX Codex +1 24 300установок a11y aladicf Скилл a11y для Claude Code разбирает интерфейс по клавиатуре, скринридеру, контрасту и семантике. Правит найденное, включая компоненты, не работающие без мыши. CX Codex +1 641установок accessibility-compliance Seth Hobson Скилл accessibility-compliance для Claude Code помогает создавать интерфейсы по стандарту WCAG 2.2. Запускается при проведении аудита доступности и внедрении ARIA-паттернов. CX Codex +1 14 596установок accessibility-diff AccessLint Скилл accessibility-diff сравнивает нарушения доступности на живой странице до и после ваших правок. Показывает, что вы сломали, а что починили. CX Codex +1 1 200установок accessibility-audit rampstackco Скилл accessibility-audit проводит аудит доступности интерфейса по стандарту WCAG 2.1 AA и формирует план исправления ошибок. Пригодится перед релизом и при подготовке к проверкам ADA или Section 508. CX Codex +1 364установок

Из того же набора86

Весь набор →
vite-advanced Скилл vite-advanced для Claude Code и Codex настраивает сборку Vite 8 на Rolldown, разделение чанков и Environment API. Включается при правке vite.config.* или файлов в каталогах **/vite/**. CX Codex +1 265установок quality-gates Скилл quality-gates оценивает сложность задач от 1 до 5 и останавливает агента при тупиках или оверинжиниринге. Включается перед запуском фич и после неудачных попыток решения. CX Codex +1 259установок code-review-playbook Скилл code-review-playbook задаёт правила ревью кода, шаблоны conventional comments и чеклисты безопасности. Подключается при проверке чужих пулл-реквестов или перед сдачей собственной ветки. CX Codex +1 254установок python-backend Скилл python-backend для Claude Code и Codex подтягивает правила асинхронного бэкенда на Python при работе с файлами *.py и манифестами зависимостей. Настраивает связку FastAPI, SQLAlchemy 2.0 и asyncio. CX Codex +1 250установок memory-fabric Скилл memory-fabric для Claude Code управляет поиском по графу знаний, парсит запросы, объединяет дубликаты и ранжирует факты. Включается при отладке внутренней логики памяти агента. CX Codex +1 244установок multimodal-llm Скилл multimodal-llm для Claude Code и Codex подбирает архитектурные паттерны для работы со зрением, речью и генерацией видео. Агент подключает его при распознавании изображений, транскрипции аудио и вызовах видео-API. CX Codex +1 243установок database-patterns Скилл database-patterns помогает проектировать схемы, создавать миграции Alembic и находить расхождения между версиями базы. Включается при работе с SQL и NoSQL. CX Codex +1 238установок architecture-patterns Скилл architecture-patterns проверяет соблюдение чистой архитектуры, деление бэкенда на слои и глубину вложенности папок. Включается при проектировании границ сервисов и рефакторинге. CX Codex +1 236установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой