Кнопка-значок без названия, поле формы только с заполнителем или удалённая рамка фокуса делают сайт недоступным для пользователей программ чтения с экрана и клавиатуры. Именно с таких нарушений начинаются аудиты доступности и жалобы. Этот навык выявляет эти и ещё одиннадцать распространённых нарушений WCAG в HTML и CSS и объясняет, как исправить каждое из них.

Ваш агент запускает сканер для страниц .html и файлов .css. Сканер разбирает HTML (пропускает комментарии, точно определяет номера строк), определяет доступное имя каждой кнопки и ссылки по тексту, скрытому тексту, aria-label и alt изображения, а подпись каждого поля - по <label for>, охватывающему элементу label или атрибутам ARIA. Шаблонный код ({{ }}, {% %}) считается присутствующим содержимым. Он никогда не открывает браузер. Результат: BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного решения.

Что проверяется

БЛОКИРОВКА (исправить до выпуска)

• A01: изображения без alt-текста

• A02: поля формы без подписи (только с заполнителем)

• A03: кнопки и ссылки без доступного имени

• A04: язык страницы не указан в <html>

• A05: обработчики нажатий на div и span, недоступных с клавиатуры

ПРОВЕРКА (проверить до выпуска)

• A11: положительный tabindex

• A12: отключено масштабирование жестом сведения и разведения пальцев

• A13: пропущены уровни заголовков

• A14: iframe без title

• A15: автоматическое воспроизведение видео или аудио со звуком

• A16: повторяющиеся идентификаторы id

• A17: aria-hidden у элементов, способных получать фокус

• A18: таблицы данных без ячеек заголовков

• A19: рамки фокуса удалены в CSS

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с объяснением причин, критерием WCAG и более безопасным решением для каждого правила

• Пример страницы с CSS, содержащий риски, и безопасный вариант, а также реальный отчёт сканера по примеру с рисками

Ограничения

Сканер читает каждый файл в его текущем виде, а не страницу, которую формирует браузер: содержимое, добавляемое JavaScript-фреймворками, цветовой контраст, субтитры и поведение программ чтения с экрана по-прежнему требуют ручной проверки. Автоматические проверки выявляют лишь часть всех проблем доступности. Статус NOT FLAGGED не даёт гарантий.

Содержимое

Один ZIP-архив с 9 файлами: SKILL.md, сканер в scripts/ (2 файла Python), references/rules.md (каждое правило с объяснением причин и более безопасным решением) и examples/ (4 файла примеров плюс report.md, реальный отчёт сканера по примеру с рисками).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте её в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты также можно запускать отдельно с Python 3.9 или новее, ничего дополнительно устанавливать не нужно. Они только читают ваши файлы: не обращаются к сети и ничего никуда не отправляют.