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

accessibility-audit · rampstackco — скилл для Claude Code

Скилл accessibility-audit проводит аудит доступности интерфейса по стандарту WCAG 2.1 AA и формирует план исправления ошибок. Пригодится перед релизом и при подготовке к проверкам ADA или Section 508.

MIT 364 установок ★ 1 107 обновлён 2026-10-19

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

Что делает accessibility-audit

Скилл оценивает веб-приложения по четырём принципам WCAG: воспринимаемость, управляемость, понятность и надёжность разметки. Он не привязан к конкретному стеку и копает глубже базовых тестов дизайна. В проверку входят семантика HTML, текстовые альтернативы для медиа, контрастность 4.5:1, доступность с клавиатуры без ловушек фокуса и корректная озвучка через скринридеры вроде VoiceOver или NVDA.

Процесс разбит на этапы: автосканирование сканерами (axe, Lighthouse, Pa11y), ручной проход табом и стрелками, сверка со скринридером, проверка адаптивности при зуме 200% и чёткости сообщений об ошибках. Автоматика ловит до 50% проблем, поэтому ручные тесты обязательны.

Для работы скиллу нужны URL или исходники проекта, скоуп проверки и целевой стандарт.

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

  • Проверить сайт на соответствие критериям WCAG 2.1 AA
  • Найти ловушки фокуса и наладить навигацию только с клавиатуры
  • Проверить разметку и формы на корректную работу со скринридерами
  • Составить пошаговый план устранения дефектов доступности

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

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

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

1Через Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill accessibility-audit -a claude-code

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

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

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

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

Вопросы об accessibility-audit

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

Выполните команду npx skills add rampstackco/claude-skills --skill accessibility-audit -a claude-code в терминале.

Для каких задач нужен этот скилл?

Он помогает провести глубокий аудит интерфейса по критериям доступности и сформировать план устранения замечаний перед аудитом или релизом.

Чем он отличается от базовых проверок в тестах верстки?

Скилл фокусируется целиком на доступности: он включает проверку экранными дикторами, навигацию без мыши, зум до 200% и анализ понятности ошибок ввода.

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

SKILL.md · MIT
---
name: accessibility-audit
description: "Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles. Use this skill whenever the user wants to audit accessibility, review WCAG compliance, fix accessibility issues, prepare for accessibility certification, address an accessibility lawsuit risk, or systematically improve a site's accessibility. Triggers on accessibility audit, WCAG audit, a11y audit, accessibility compliance, ADA compliance, screen reader test, keyboard navigation, accessibility report, fix accessibility, axe scan. Also triggers when accessibility issues have been reported and need systematic remediation."
category: development
catalog_summary: "WCAG compliance audit with remediation plan"
display_order: 3
---

# Accessibility Audit

Run a thorough accessibility audit and produce a remediation plan. Stack-agnostic. Anchored to WCAG 2.1 AA, with notes on AAA where relevant.

This skill goes deeper than the accessibility checks in `qa-testing` and `design-standards`. Use this when accessibility itself is the goal.

---

## When to use

- Pre-launch accessibility verification
- Compliance preparation (ADA, EN 301 549, AODA, Section 508)
- Remediation after an audit finding or complaint
- Annual or quarterly accessibility health check
- Onboarding accessibility into a team that hasn't prioritized it before

## When NOT to use

- General QA after deploys (use `qa-testing`)
- Component-level accessibility implementation (use `frontend-component-build`)
- Color contrast for design tokens (use `design-standards` or `brand-identity`)

---

## Required inputs

- The site or product under audit
- The scope (full site, specific section, specific user flow)
- The target standard (WCAG 2.1 AA is most common)
- Any specific concerns or known issues
- Tools available (automated scanners, screen readers, manual testing)

---

## The framework: WCAG's 4 principles

WCAG organizes accessibility around four principles. The audit covers each in depth.

### 1. Perceivable

Information and UI must be presentable in ways users can perceive.

**Audit checks:**

- **Text alternatives.** All non-decorative images have descriptive `alt` text. Decorative images use `alt=""`. Complex images (charts, infographics) have long descriptions.
- **Time-based media.** Videos have captions. Pre-recorded audio has transcripts. Live audio has live captions where required.
- **Adaptable.** Content structure is conveyed through markup (semantic HTML), not just visual styling. Reading order makes sense when CSS is disabled.
- **Distinguishable.** Color is not the sole means of conveying information. Text contrast meets AA (4.5:1 normal, 3:1 large). UI element contrast meets 3:1. Audio can be paused, stopped, or muted.

### 2. Operable

UI components and navigation must be operable.

**Audit checks:**

- **Keyboard accessible.** All functionality available via keyboard alone. No keyboard traps. Focus visible.
- **Enough time.** Time limits can be adjusted, paused, or extended. Auto-updating content can be paused.
- **Seizures and physical reactions.** No content that flashes more than 3 times per second.
- **Navigable.** Skip links present. Pages have descriptive titles. Focus order is logical. Link purpose clear from text or context. Multiple ways to find pages (sitemap, search, navigation). Headings and labels are descriptive.
- **Input modalities.** Pointer gestures have keyboard alternatives. Pointer cancellation supported (mouse-up, not mouse-down for activation). Labels match accessible names. Motion-triggered functionality has alternatives.

### 3. Understandable

Information and operation must be understandable.

**Audit checks:**

- **Readable.** Page language declared (`<html lang="...">`). Unusual words and abbreviations have definitions or expansions. Reading level appropriate to audience.
- **Predictable.** Focus does not change context unexpectedly. Input does not change context unexpectedly. Navigation is consistent across pages. Components that look similar behave similarly.
- **Input assistance.** Errors are identified clearly. Labels and instructions are provided for input. Error suggestions are given where possible. For pages handling legal commitments or financial transactions, errors can be reviewed and corrected before submission.

### 4. Robust

Content must be robust enough to work with current and future user agents.

**Audit checks:**

- **Compatible.** Markup is valid. Name, role, and value of UI components are programmatically determinable. Status messages can be programmatically determined and announced.

---

## Audit methodology

### Stage 1: Automated scan

Run automated scanners across the priority pages. These catch 30 to 50 percent of issues but miss the rest.

**Tools:**
- axe DevTools (browser extension)
- Lighthouse (Chrome DevTools accessibility audit)
- WAVE (browser extension)
- Pa11y (CLI for batch scanning)

**Output:** A list of automated findings, by page.

### Stage 2: Manual keyboard testing

Unplug the mouse. Navigate the priority user flows using only keyboard.

**Test:**
- Tab and Shift+Tab move through interactive elements in logical order
- Enter activates buttons and links
- Space activates buttons (and toggles checkboxes)
- Arrow keys navigate within composite widgets (tabs, menus, listboxes)
- Escape dismisses modals, popovers, menus
- Focus is always visible
- Focus returns to a sensible place after modals or popovers close
- No keyboard trap (focus can always leave)

**Document:** Any flow where keyboard navigation breaks down.

### Stage 3: Screen reader testing

Test with at least one real screen reader, or state the gap per the data-availability rule. Each combination has quirks.

**Common combinations:**
- VoiceOver + Safari (macOS / iOS)
- NVDA + Firefox or Chrome (Windows)
- JAWS + Chrome (Windows; commercial but common in enterprise)
- TalkBack + Chrome (Android)

**Test:**
- Page structure announced correctly (headings, landmarks)
- Form labels read with their inputs
- Errors announced when they appear
- Status changes announced (loading, success, error)
- Modal context announced when opened
- Images have meaningful alt text (or are correctly identified as decorative)

### Stage 4: Visual testing

Verify the visual aspects of accessibility.

**Test:**
- Color contrast for all text/background pairs (use a contrast checker)
- UI element contrast (3:1 for icons, borders, focus rings)
- Color-blindness simulation (deuteranopia at minimum)
- Zoom to 200% - content remains usable, no horizontal scroll
- Reflow at 320px viewport
- Text spacing applied (line height, letter spacing) - no content cut off
- Motion can be reduced (`prefers-reduced-motion` honored)

### Stage 5: Cognitive accessibility

Often overlooked. Critical for inclusive products.

**Test:**
- Reading level appropriate
- Instructions clear
- Error messages explain how to fix the error, not just that one occurred
- Forms allow correction before submission
- Time limits avoidable or extendable
- Important content not dependent on memory of prior pages

---

## Workflow

1. **Define scope.** Full site? Specific flows? Specific page templates?
2. **Run automated scans.** Document findings per page.
3. **Manual keyboard pass.** Test all priority flows.
4. **Screen reader pass.** Test with at least one combination.
5. **Visual checks.** Contrast, zoom, color blindness, motion.
6. **Cognitive checks.** Reading level, error handling, time limits.
7. **Score against WCAG.** Per success criterion (level A, AA, AAA).
8. **Prioritize findings.** Critical (blocks users), Important (degrades experience), Minor (polish).
9. **Write the report.** Use the template in [`references/audit-report-template.md`](references/audit-report-template.md).
10. **Build a remediation plan.** Sequenced fixes with effort and impact estimates.

---

## Severity classification

For prioritization:

**Critical (P0):**
- Blocks an entire user flow for an assistive-tech user
- Renders a key page completely inaccessible
- Examples: form with no labels, modal without focus management, primary CTA not keyboard-accessible

**Important (P1):**
- Significantly degrades the experience for assistive-tech users
- Examples: missing alt text on key images, low-contrast body text, error messages that don't announce

**Minor (P2):**
- Affects edge cases or specific assistive technology combinations
- Examples: minor focus order issues, missing decorative alt attributes, edge case keyboard handling

**Polish (P3):**
- Above-AA improvements that benefit accessibility but aren't compliance-blocking
- Examples: AAA contrast targets, additional reduced-motion variants, language attributes on inline foreign words

---

## Failure patterns

- **Automated scan only.** Catches 30 to 50 percent of issues. The remaining 50 to 70 percent are in keyboard, screen reader, and cognitive testing.
- **Testing only on the home page.** The home page is usually the most accessible. Bugs hide in deeper flows.
- **Treating accessibility as a one-time project.** Accessibility erodes with every deploy. Bake it into the development cycle.
- **Fixing without root cause.** Patching individual issues without understanding why they happened means new ones keep appearing.
- **Ignoring screen reader testing.** Hard to do well, easy to skip. Single biggest source of "we thought we were accessible" surprises.
- **Confusing AA and AAA.** AAA is rarely the right target. AA is the practical baseline for most products.
- **Treating accessibility as a designer or developer responsibility alone.** Content, product, QA, and leadership all need to participate.
- **Assuming compliance equals accessibility.** WCAG conformance is a floor, not a ceiling. Real users may still struggle.

---

## Output format

Default output is a comprehensive audit report at `accessibility-audit.md`.

Structure:
1. Executive summary
2. Methodology (tools used, pages tested, screen readers used)
3. Findings by WCAG principle
4. Critical findings (P0) with specific URLs and fixes
5. Important findings (P1)
6. Minor findings (P2)
7. Polish (P3)
8. Remediation roadmap (sequenced and prioritized)
9. Appendices (full automated scan results, keyboard navigation notes, screen reader notes)

Plus a remediation tracking spreadsheet with one row per finding.

---

## If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.

---

## Reference files

- [`references/audit-report-template.md`](references/audit-report-template.md) - Full audit report template.
- [`references/wcag-quick-reference.md`](references/wcag-quick-reference.md) - Condensed WCAG 2.1 AA criteria with audit checks.
- [`references/aria-patterns.md`](references/aria-patterns.md) - Decision-grade ARIA patterns. Semantic-HTML-first principle, common interactive widgets (accordion, tabs, modal, toggle, disclosure, navigation), live regions, hiding patterns, labeling, state indicators, anti-patterns.

© rampstackco · MIT · rampstackco/claude-skills

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

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

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

accessibility-audit Owl-Listener Скилл accessibility-audit проверяет готовый интерфейс по WCAG и выдаёт проблемы с уровнем серьёзности, влиянием и шагами исправления. CX Codex +1 2 600установок accessibility-audit AccessLint Скилл accessibility-audit проводит глубокую проверку доступности сайта по стандарту WCAG 2.2 и методологии WCAG-EM. Он собирает выборку страниц, запускает тесты и формирует итоговый отчёт о соответствии. CX Codex +1 1 400установок better-accessibility jakubkrehel Скилл better-accessibility для Claude Code проверяет интерфейс по стандарту WCAG 2.2 и правит фокус, клавиатурную навигацию, формы и разметку ARIA под экранные дикторы. CX Codex +1 39 300установок accessibility-testing proffesor-for-testing Скилл accessibility-testing для проверки интерфейса на WCAG 2.2: клавиатурная навигация, контраст и работа со скринридерами, с готовыми шаблонами тестов. CX Codex +1 1установок a11y-audit Alireza Rezvani Плагин a11y-audit ищет и правит нарушения доступности WCAG 2.2 во фронтенд-проектах: React, Next.js, Vue, Angular, Svelte и обычном HTML. ★ 30 251звёзд репо accessibility-agents Community Access (Jeff Bishop and Taylor Arndt) Плагин accessibility-agents для GitHub Copilot направляет задачи по доступности подходящим специалистам. Проверяет интерфейсы и документы на соответствие WCAG 2.2 AA и блокирует правки пользовательских файлов до проверки. ★ 453звёзд репо accessibility-compliance-accessibility-audit sickn33 Скилл accessibility-compliance-accessibility-audit проверяет страницы и пользовательские сценарии по заданному уровню WCAG. Он помогает найти барьеры для клавиатуры, скринридера, фокуса и контраста. CX Codex +1 1установок Web Accessibility taste f Промпт Web Accessibility taste задаёт правила доступности интерфейсов для фронтенд-разработки. Помогает писать семантичный код и правильно настраивать клавиатурную навигацию. GP ChatGPT ★ 178 201звёзд репо

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

Весь набор →
email-deliverability Скилл email-deliverability разбирает доставляемость писем: настраивает SPF, DKIM и DMARC, следит за репутацией отправителя и подсказывает, почему письма падают в спам. CX Codex +1 372установок design-system Скилл design-system для Claude Code и других платформ: собирает или проверяет дизайн-систему — токены, компоненты, именование, контрибуцию и документацию. Держит стиль продуктов согласованным. CX Codex +1 369установок brand-voice Скилл brand-voice помогает составить гайдлайн по тону и голосу бренда с правилами лексики, контекстными сдвигами и парными примерами текста. CX Codex +1 367установок brand-discovery Скилл brand-discovery собирает данные об аудитории, конкурентах и категории, затем предлагает возможные направления позиционирования. Пригодится в начале проекта, до брифа и творческой концепции. CX Codex +1 366установок information-architecture Скилл information-architecture проектирует структуру сайта или продукта: карту страниц, навигацию, URL, типы контента и таксономию. Нужен при создании и перестройке IA. CX Codex +1 354установок creative-brief Скилл creative-brief для Claude Code превращает смутную идею в конкретный брифинг. Задаёт вопросы, чтобы выровнять команду и зафиксировать требования до первой строки кода. CX Codex +1 354установок seo-technical Скилл seo-technical проводит технический SEO-аудит: краулинг, индексация, рендеринг, архитектура, структурированные данные, Core Web Vitals, безопасность и мультиязычность. CX Codex +1 347установок seo-onpage Скилл seo-onpage проверяет одну страницу по восьми направлениям: title, meta description, заголовки, текст, внутренние ссылки, картинки, URL и schema. На выходе — отчёт с правками. CX Codex +1 347установок

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

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