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

accessibility · oakoss — скилл для Claude Code: доступность интерфейсов

Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров.

MIT 164 установок ★ 29 обновлён 2026-08-17

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

Что делает accessibility

Скилл подсказывает, как выбирать семантические HTML-элементы, задавать ARIA-атрибуты и настраивать клавиатурное управление. Он охватывает формы, диалоги, вкладки, динамические сообщения, ссылки для пропуска навигации, альтернативный текст и таблицы данных.

Внутри — рекомендации по контрасту, видимому фокусу, размерам целей и критериям WCAG 2.2 AA. Есть примеры клавиш для управления виджетами и список типичных ошибок: например, замена кнопки на элемент с onClick или скрытие интерактивного элемента через aria-hidden. Если проект использует такие паттерны, проверьте их при аудите.

Скилл доступен для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для установки в Claude Code выполните npx skills add oakoss/agent-skills --skill accessibility -a claude-code; файл скилла находится по пути ~/.claude/skills/accessibility/SKILL.md.

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

  • проверить интерфейс на соответствие WCAG 2.2 AA
  • заменить несемантические элементы управления HTML-кнопками
  • настроить видимый фокус и управление с клавиатуры
  • исправить подписи форм и объявления динамических сообщений

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

  • Проверь эту форму на соответствие WCAG 2.2 AA и предложи исправления.
  • Замени кликабельные div на подходящие семантические элементы.
  • Проверь диалог: фокус, клавиша Escape и доступность для скринридера.

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

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill accessibility -a claude-code

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

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

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

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

Вопросы об accessibility

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

Выполните npx skills add oakoss/agent-skills --skill accessibility -a claude-code. Файл скилла находится в ~/.claude/skills/accessibility/SKILL.md.

Что делает скилл accessibility?

Он помогает реализовать и проверять доступность веб-интерфейсов по WCAG 2.2 AA. В рекомендациях есть семантическая разметка, ARIA, клавиатурная навигация и работа с фокусом.

Какие требования WCAG 2.2 AA охватывает скилл?

Среди тем — контраст текста и элементов управления, видимость фокуса, размер интерактивных целей и альтернативы перетаскиванию. Также рассматриваются повторный ввод данных и доступная аутентификация.

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

SKILL.md · MIT
---
name: accessibility
description: |
  Build WCAG 2.2 AA compliant interfaces with semantic HTML, ARIA, keyboard navigation, focus management, color contrast, and screen reader support. Covers forms, dialogs, tabs, live regions, skip links, alt text, and data tables.

  Use when implementing accessible UIs, auditing WCAG compliance, fixing screen reader issues, keyboard navigation, focus traps, or troubleshooting "focus outline missing", "aria-label required", "insufficient contrast", "missing alt text", "heading hierarchy".
license: MIT
metadata:
  author: oakoss
  version: '1.1'
user-invocable: false
---

# Web Accessibility (WCAG 2.2 AA)

Build for everyone — accessibility is a requirement, not a feature.

## Contrast Ratios (WCAG AA)

| Element                            | Minimum Ratio |
| ---------------------------------- | ------------- |
| Normal text (< 18pt)               | 4.5:1         |
| Large text (>= 18pt or 14pt bold)  | 3:1           |
| UI components and focus indicators | 3:1           |

## WCAG 2.2 New AA Criteria

| Criterion                           | Requirement                                                                          |
| ----------------------------------- | ------------------------------------------------------------------------------------ |
| Target Size Minimum (2.5.8)         | Interactive targets at least 24x24 CSS pixels                                        |
| Focus Not Obscured Minimum (2.4.11) | Focused element at least partially visible, not hidden by sticky headers or overlays |
| Focus Appearance (2.4.13)           | Focus indicator has minimum area (2px perimeter) and 3:1 contrast change             |
| Dragging Movements (2.5.7)          | Provide single-pointer alternative for any drag interaction                          |
| Redundant Entry (3.3.7)             | Do not require re-entering previously provided information                           |
| Consistent Help (3.2.6)             | Help mechanisms (chat, phone, FAQ) appear in same relative order across pages        |
| Accessible Authentication (3.3.8)   | No cognitive function test for login (allow paste, autofill, or alternatives)        |

## Essential Keyboard Patterns

| Key             | Action                                |
| --------------- | ------------------------------------- |
| Tab / Shift+Tab | Navigate between focusable elements   |
| Enter / Space   | Activate buttons and links            |
| Arrow keys      | Navigate within widgets (tabs, menus) |
| Escape          | Close dialogs and menus               |
| Home / End      | Jump to first/last item in widget     |

## Element Selection

| Need                   | Element                           |
| ---------------------- | --------------------------------- |
| Navigates to page      | `<a href="...">`                  |
| Submits form           | `<button type="submit">`          |
| Opens dialog           | `<button aria-haspopup="dialog">` |
| Other action           | `<button type="button">`          |
| Self-contained article | `<article>`                       |
| Navigation links       | `<nav>`                           |
| Supplementary info     | `<aside>`                         |

## Common ARIA Attributes

| Attribute              | Purpose                                            |
| ---------------------- | -------------------------------------------------- |
| `aria-label`           | Name when no visible label exists                  |
| `aria-labelledby`      | Reference existing text as label                   |
| `aria-describedby`     | Additional description (hints, errors)             |
| `aria-live`            | Announce dynamic updates (`polite` or `assertive`) |
| `aria-expanded`        | Collapsible/expandable state                       |
| `aria-hidden="true"`   | Hide decorative elements from screen readers       |
| `aria-invalid`         | Mark form fields with errors                       |
| `aria-required="true"` | Mark required fields                               |
| `aria-busy`            | Indicate loading state                             |

## WCAG 2.2 AA Checklist Summary

| Principle      | Key Requirements                                                                                                                             |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Perceivable    | Alt text on images, contrast >= 4.5:1, color not sole indicator, text resizable to 200%, captions on video, `prefers-reduced-motion` support |
| Operable       | Keyboard accessible, visible focus not obscured, focus appearance meets minimum, targets >= 24px, skip links, dragging alternatives          |
| Understandable | `<html lang="en">`, consistent navigation, consistent help placement, form labels, error identification, no redundant entry, accessible auth |
| Robust         | Valid HTML, name/role/value on all UI components, `aria-live` for status messages (SC 4.1.1 Parsing is obsolete in WCAG 2.2)                 |

## Anti-Patterns

| Anti-Pattern                          | Fix                                               |
| ------------------------------------- | ------------------------------------------------- |
| `<div onClick>` instead of `<button>` | Use semantic HTML elements                        |
| `outline: none` without replacement   | Use `:focus-visible` with visible outline         |
| Placeholder as label                  | Use `<label>` element                             |
| `tabindex` > 0                        | Use DOM order or `tabindex="0"` / `tabindex="-1"` |
| Color-only state indicators           | Add icon and text label                           |
| Skipped heading levels                | Use sequential h1-h6, style with CSS              |
| `role="button"` on `<button>`         | Remove redundant ARIA                             |
| `aria-hidden` on interactive elements | Never hide interactive content                    |
| Fixed font sizes (px)                 | Use `rem` units                                   |
| No focus trap in modal dialogs        | Trap focus, close on Escape                       |

## Common Mistakes

| Mistake                                                        | Correct Pattern                                                                                      |
| -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Adding `aria-label` to elements that already have visible text | Use `aria-labelledby` to reference existing visible text instead                                     |
| Using `aria-live="assertive"` for non-urgent updates           | Use `aria-live="polite"` for most dynamic content; reserve `assertive` for errors and alerts         |
| Setting `alt=""` on informative images                         | Provide descriptive alt text; only use empty alt on purely decorative images                         |
| Adding keyboard handlers to non-focusable elements             | Use native interactive elements or add `tabindex="0"` plus `role` and key handlers                   |
| Testing only with automated tools like axe                     | Automated scans catch ~30% of issues; always supplement with keyboard-only and screen reader testing |

## Screen Reader and Browser Pairings

| Screen Reader | Browser | Platform           |
| ------------- | ------- | ------------------ |
| JAWS          | Chrome  | Windows            |
| NVDA          | Chrome  | Windows (free)     |
| NVDA          | Firefox | Windows (free)     |
| VoiceOver     | Safari  | macOS / iOS        |
| TalkBack      | Chrome  | Android            |
| Narrator      | Edge    | Windows (built-in) |

## Testing Quick Guide

| Method         | Tool                                    | Effort  |
| -------------- | --------------------------------------- | ------- |
| Keyboard-only  | Hide mouse, Tab through page            | 5 min   |
| Screen reader  | JAWS + Chrome or NVDA + Chrome/Firefox  | 10 min  |
| Screen reader  | VoiceOver + Safari (macOS)              | 10 min  |
| Automated scan | axe DevTools browser extension          | 2 min   |
| Lighthouse     | Chrome F12 > Lighthouse > Accessibility | 2 min   |
| Unit tests     | jest-axe (Jest) or vitest-axe (Vitest)  | Ongoing |

## Delegation

When working on accessibility, delegate to:

- `design-system` — Color tokens and contrast verification
- `react-patterns` — Component patterns and hooks
- `testing` — jest-axe integration and test patterns

## Resources

- [WCAG 2.2 Quick Reference](https://www.w3.org/WAI/WCAG22/quickref/)
- [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/)
- [MDN Accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility)
- [WebAIM](https://webaim.org/)
- [The A11y Project](https://www.a11yproject.com/)

## References

- [Semantic HTML and Structure](references/semantic-html.md) — Document landmarks, heading hierarchy, element selection, skip links
- [Focus Management](references/focus-management.md) — Focus indicators, focus not obscured, dialog focus traps, SPA route focus, focus-visible patterns
- [ARIA Patterns](references/aria-patterns.md) — Accessible tabs, live regions, data tables with ARIA attributes
- [Forms and Validation](references/forms-validation.md) — Label association, error announcement, redundant entry, accessible authentication
- [Color and Media](references/color-and-media.md) — Contrast requirements, reduced motion, dragging alternatives, video captions, alt text
- [Testing](references/testing.md) — Keyboard testing, screen reader pairings, axe DevTools, jest-axe and vitest-axe unit tests

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Фронтенд и 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 OrchestKit Скилл accessibility для Claude Code помогает добавлять доступность в веб-интерфейсы. Активируется при работе с клавиатурной навигацией, экранными дикторами и ARIA-компонентами. CX Codex +1 246установок 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звёзд репо accessibility-auditor davila7 Скилл accessibility-auditor проверяет веб-интерфейсы на доступность и подсказывает исправления для WCAG, ARIA, клавиатурной навигации и скринридеров. CX Codex +1 846установок accessibility-expert Seth Hobson Субагент accessibility-expert для Claude Code проверяет доступность интерфейсов по WCAG, выявляет барьеры и предлагает исправления. Помогает с аудитом компонентов и a11y-тестами. CX Codex ★ 42 780звёзд репо accessibility-specialist rohitg00 Субагент accessibility-specialist для Claude Code проверяет интерфейсы по WCAG 2.2, клавиатуре, скринридерам и ARIA. Проводит аудит UI перед завершением задачи. CX Codex ★ 2 858звёзд репо fixing-accessibility ibelick Скилл fixing-accessibility для Claude Code проверяет HTML на проблемы доступности и предлагает точечные исправления. Проверяет формы, диалоги и интерактивные элементы. CX Codex +1 24 300установок wcag-audit-patterns Seth Hobson Скилл wcag-audit-patterns проверяет веб-интерфейс по WCAG 2.2, сочетая автотесты и ручную проверку. Нужен при поиске нарушений и внедрении доступных паттернов. CX Codex +1 12 486установок a11y aladicf Скилл a11y для Claude Code разбирает интерфейс по клавиатуре, скринридеру, контрасту и семантике. Правит найденное, включая компоненты, не работающие без мыши. CX Codex +1 641установок

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

Весь набор →
shadcn-ui Учит агента работать с shadcn/ui: добавлять компоненты через CLI, настраивать темы на oklch и собирать формы с проверкой через Zod. CX Codex +1 176установок local-first Скилл local-first помогает решить, нужна ли веб-приложению локальная база с синхронизацией, и выбрать движок и стратегию разрешения конфликтов. CX Codex +1 173установок tanstack-query Помогает агенту писать запросы и мутации на TanStack Query v5, переводить код с v4 и настраивать инвалидацию кэша. CX Codex +1 170установок threejs Помогает создавать 3D-сцены на Three.js, подключать WebGPU и React Three Fiber. Помогает настраивать шейдеры, загружать модели и повышать производительность. CX Codex +1 167установок react-performance Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок design-system Скилл design-system для Claude Code собирает дизайн-систему с токенами, темами и архитектурой компонентов. Задаёт структуру для dark mode, CVA-вариантов и доступности. CX Codex +1 160установок zustand Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context. CX Codex +1 158установок tanstack-start По TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой. CX Codex +1 156установок

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

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