Перейти к руководству
accessibilityавтор Addy Osmani

Accessibility Skill.

Skill для Claude Code и Codex: аудит и улучшение веб-доступности по стандарту WCAG 2.2.

  • Дизайн-ревью и доступность
  • Отчёт ревью
addyosmani/web-quality-skills · skills/accessibility/SKILL.mdSKILL.md
--- name: accessibility description: Audit and improve web accessibility following WCAG 2.2 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible". --- ## Evidence-led audit workflow ## WCAG Principles: POUR ## Conformance levels ## Perceivable ## Operable ## Understandable
Вводная часть и заголовки разделов, прочитанные из исходного файла 2026-09-14 · 14 265 символов

01 Что делает

Что делает skill доступности в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

Этот skill проводит аудит и исправляет веб-доступность по WCAG 2.2, опираясь на POUR — Perceivable, Operable, Understandable, Robust — и уровни соответствия A, AA и AAA. Его workflow строится на доказательствах: если отрисованная страница доступна, запускается живой аудит доступности Lighthouse (lighthouse_audit через Chrome DevTools MCP), сбойные узлы указывают на нужный компонент, его состояние доступности проверяется через take_snapshot, после чего правится исходный код и аудит повторяется.

Если живых инструментов нет, Lighthouse CLI или axe закрывают автоматическую половину работы, а те же ручные проверки всё равно остаются в силе. Skill поставляется с правилами уровня кода для alt-текста, коэффициентов контраста, видимости фокуса, размера цели, reduced motion, ошибок форм и доступной аутентификации, а также со списком триажа с рангами critical, serious и moderate.

Что он выдаёт

  • Список проблем по приоритетам, разбитый на уровни Critical (исправить немедленно), Serious (исправить до запуска) и Moderate (исправить вскоре), с конкретными примерами.
  • Исправленная разметка и готовые к вставке фрагменты, включая утилиту visually-hidden, открывающую подписи иконочных кнопок вспомогательным технологиям.
  • Полные эталонные реализации в references/A11Y-PATTERNS.md: подписи полей форм, ловушка фокуса в модальных окнах, skip link, ARIA-табы, live-регионы, обработка ошибок и команды скринридеров.
Смотрите пример запроса ↗

Как это работает

  1. 01
    Запустите живой аудит доступности

    Начните с отрисованной страницы и запустите живой аудит доступности Lighthouse: режим mobile navigation для общедоступных страниц или режим snapshot, когда перезагрузка потеряет состояние авторизации.

  2. 02
    Определите сбойный компонент

    Используйте сбойные узлы аудита, чтобы указать на конкретный компонент или шаблон, а не искать по всему репозиторию общие паттерны через grep.

  3. 03
    Изучите дерево доступности

    Прочитайте снимок отрисованного дерева доступности, чтобы проверить имена, роли, состояния, ориентиры и структуру заголовков, затем пройдите затронутый сценарий с клавиатуры.

  4. 04
    Исправьте исходный код и перепроверьте

    Меняйте исходный код, а не отрисованный результат, затем повторите тот же аудит и то же ручное взаимодействие, чтобы подтвердить исправление.

  5. 05
    Запасной вариант — инструменты CLI

    Когда живых браузерных инструментов нет, сочетайте вывод Lighthouse CLI или axe с теми же ручными проверками: автоматизация закрывает лишь часть барьеров.

02 Определите своё применение

Когда использовать скилл accessibility

Используйте accessibility skill в Claude Code или Codex, когда задача — обзор дизайна такого рода. Соответствие и ограничения ниже взяты из собственного файла skill.

Хорошо подходит

  • Запрос, сформулированный как аудит a11y, работа по соответствию WCAG, поддержка скринридеров, навигация с клавиатуры или «сделай доступно».
  • Команды, нацеленные на уровень AA, который в файле считается стандартной целью и юридическим требованием во многих юрисдикциях.
  • Страницы, где залипающие шапки или подвалы проглатывают кольцо фокуса с клавиатуры, — критерий, новый в WCAG 2.2.
  • Интерфейсы, которые должны полностью работать без мыши, включая кастомные виджеты, собранные из неинтерактивных элементов.

Знайте границы

  • Встроенные текстовые ссылки, размеры, управляемые браузером, и цели, чья круглая зона 24px не пересекается с другой целью, освобождены от правила минимального размера цели.
  • Уровень AAA считается необязательным, а не требованием.
  • Антипаттерн, который отмечает файл: ручная активация с клавиатуры, добавленная к нативной кнопке, даёт двойное срабатывание, потому что Enter и Space уже вызывают click.

Что предоставить

  • Отрендеренная страницаРабочий процесс запускается, когда доступна отрендеренная страница, поскольку аудит, список узлов и дерево доступности берутся именно из неё.
  • Режим навигации страницыСообщите агенту, это обычная публичная страница или сценарий, где перезагрузка потеряет аутентифицированное состояние либо данные, созданные пользователем: от этого зависит режим мобильной навигации или режим снимка.
  • Сценарий работы с клавиатуры для проверкиБудьте готовы пройти затронутое взаимодействие с клавиатуры во время аудита — наряду с проверкой дерева доступности.

03 Внутри скилла

Правила, которые skill по доступности задаёт Claude Code и Codex

7 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт агенту, — та часть файла, которая меняет результат.

  1. Сначала используйте нативный элемент

    Нативные кнопка, ссылка и элементы формы уже обеспечивают активацию по Enter/Space, фокус и семантику для вспомогательных технологий, поэтому ручная обработка клавиатуры — крайняя мера для элементов, которые нельзя заменить.

  2. Сохраняйте заметный стиль фокуса

    Никогда не убирайте обводку фокуса.

  3. Соблюдайте минимум цели 24 × 24

    Интерактивные цели должны быть не меньше 24 × 24 CSS-пикселей на уровне AA; 44 × 44 рекомендуется как комфортный размер для касания для кнопок, чекбоксов и подписей радиокнопок.

  4. Отключайте анимацию по запросу

    При prefers-reduced-motion файл сводит длительности анимаций и переходов к 0.01ms, ограничивает число итераций значением 1 и сбрасывает scroll-behavior в auto.

  5. Не передавайте смысл только цветом

    Состояния ошибки сочетают цвет с иконкой и текстом; в разметке aria-invalid="true" идёт в паре с aria-describedby, указывающим на элемент с сообщением об ошибке.

  6. Озвучивайте ошибки и переводите на них фокус

    Передавайте ошибки скринридерам через role="alert" или aria-live, помечайте проблемные поля и при отправке переводите фокус на первую ошибку.

  7. Снижайте когнитивную нагрузку аутентификации

    Сценарии входа не должны требовать запоминания пароля или решения головоломки, если только не работает копирование с вставкой либо автозаполнение, не существует альтернативы вроде passkey или ссылки по email, или тест не использует распознавание объектов либо личный контент.

04 Применение

Установка accessibility в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавить accessibility в Claude Code, Codex или ваш агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

Terminal
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

Универсальная форма CLI skills для skills/accessibility/SKILL.md; репозиторий может указывать собственный путь.

Дайте скиллу первую задачу по проверке дизайна

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt
Audit [page URL or route] with Lighthouse and then fix the accessibility problems in the source. The form inputs in [component path] have no programmatically associated labels, the icon buttons have no accessible names, and focus outlines are being removed on [element]. Re-run the same audit afterwards and check keyboard navigation and target sizes.

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

  • Пройдите всю страницу клавишей Tab и активируйте элементы управления клавишами Enter и Пробел.

В OpenDesign импортируйте accessibility по ссылке из его SKILL.md: Plugins → Add → Skill → Import from link, затем выберите его на верхней панели.

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

Откуда взяты факты на этой странице и когда они были последний раз проверены.

Файл skill
skills/accessibility/SKILL.md Контрольная сумма содержимого записана при верификации; коммит afa8da9
License
MIT Из LICENSE; SKILL.md указывает «MIT».
Звёзды репозитория
2,786 Снимок GitHub сделан 2026-09-14 для всего репозитория addyosmani/web-quality-skills. Не является рейтингом или счетчиком использования для accessibility.
Проверено OpenDesign
2026-09-14 Исходный файл, путь, текст лицензии и количество звезд были проверены. Не входит в основной комплект OpenDesign (проверено 2026-08-28); живой запуск не был записан на этой странице.
Собственное описание skill
«Проверить и улучшить веб-доступность согласно рекомендациям WCAG 2.2. Используется, когда просят „улучшить доступность", „аудит a11y", „соответствие WCAG", „поддержка программ чтения с экрана", „навигация с клавиатуры" или „сделать доступным".»

Описание из front-matter в SKILL.md. Полный файл содержит около 14,265 символов. Читать полный файл на GitHub.

Accessibility

Запустите accessibility на реальной задаче проверки дизайна.

Скачайте OpenDesign, импортируйте accessibility по его ссылке на SKILL.md, вставьте запрос выше и прочитайте план перед результатом.

Терминал
npx skills add https://github.com/addyosmani/web-quality-skills --skill accessibility

OpenDesign для компьютера

Одна дизайн-система. Единый образ бренда во всех материалах

В полном Vibe Design Workspace одни и те же правила бренда работают для сайтов, слайдов, интерактивных прототипов, дашбордов, изображений и HTML-видео. Подключите локальные Codex, Claude Code, Cursor и другие кодинг-агенты и создавайте бесплатно.

  • Сайты, слайды, прототипы, дашборды, изображения и видео
  • Более 140 дизайн-систем и полная библиотека шаблонов и навыков
  • Локальный Codex и более 21 кодинг-агента · Бесплатно
Скачать бесплатно

Для macOS и Windows