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

accessibility-testing · proffesor-for-testing — скилл для Claude Code: WCAG и как установить

Скилл accessibility-testing для проверки интерфейса на WCAG 2.2: клавиатурная навигация, контраст и работа со скринридерами, с готовыми шаблонами тестов.

MIT 1 установок ★ 533 обновлён 2026-10-25

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

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

Скилл даёт карточку с чек-листами и кодом для проверки доступности интерфейса: принципы восприимчивости, управляемости, понятности и устойчивости к ассистивным технологиям, требования к контрасту текста (4.5:1 для обычного и 3:1 для крупного) и примеры тестов на Playwright с @axe-core/playwright для проверки клавиатурной навигации, видимости фокуса и ARIA-разметки.

Автор скилла советует для полноценного аудита с axe-core, pa11y и Lighthouse использовать отдельный скилл a11y-ally, который работает через fleet-движок qe-browser на Vibium WebDriver BiDi, а не через Playwright. Этот скилл задуман как краткий справочник по базовым паттернам, а не замена полноценному аудиту.

Автоматические проверки axe-core закрывают только часть проблем с доступностью, остальное требует ручного тестирования с реальными скринридерами — VoiceOver, NVDA, JAWS.

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

  • проверить интерфейс на соответствие WCAG 2.2 перед релизом
  • протестировать клавиатурную навигацию по Tab, Enter, Escape
  • подготовиться к аудиту ADA или Section 508
  • проверить контраст текста и видимость фокуса
  • написать тесты на axe-core для CI/CD

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

  • Проверь страницу чекаута на соответствие WCAG 2.2 AA
  • Напиши тест на Playwright с axe-core для проверки фокуса и ARIA
  • Составь чек-лист по скринридеру VoiceOver для этой формы

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

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill accessibility-testing -a claude-code

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

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

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

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

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

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

Выполните npx skills add proffesor-for-testing/agentic-qe --skill accessibility-testing -a claude-code, скилл появится в ~/.claude/skills/accessibility-testing/SKILL.md.

Что делает accessibility-testing?

Скилл содержит чек-листы и примеры кода для проверки интерфейса по принципам POUR, тестирования клавиатурной навигации, контраста и совместимости со скринридерами, а также шаблоны тестов на axe-core.

Чем accessibility-testing отличается от a11y-ally?

Этот скилл — краткий справочник по базовым паттернам на Playwright и axe-core, а для полного аудита с pa11y, Lighthouse и движком Vibium автор советует отдельный скилл a11y-ally.

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

SKILL.md · MIT
---
name: accessibility-testing
description: "WCAG 2.2 compliance testing, screen reader validation, and inclusive design verification. Use when ensuring legal compliance (ADA, Section 508), testing for disabilities, or building accessible applications for 1 billion disabled users globally."
category: specialized-testing
priority: high
tokenEstimate: 1100
agents: [qe-visual-tester, qe-test-generator, qe-quality-gate, qe-accessibility-auditor]
implementation_status: optimized
optimization_version: 1.0
last_optimized: 2025-12-02
dependencies: []
quick_reference_card: true
tags: [accessibility, wcag, a11y, screen-reader, ada, section-508, inclusive]
# ADR-056 Trust Tier 3 Validation Stack
trust_tier: 3
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/accessibility-testing.yaml
---

# Accessibility Testing

> **Consolidated**: For comprehensive WCAG auditing with multi-tool testing (axe-core + pa11y + Lighthouse), video accessibility, and remediation, prefer [`/a11y-ally`](../a11y-ally/). This skill provides a quick reference card for basic accessibility testing patterns.

## Browser engine

Browser-driven a11y checks should go through the **qe-browser** fleet skill. `vibium a11y-tree --json` returns the full accessibility tree without visual rendering — feed it into axe-core via `vibium eval --stdin` for ruleset enforcement. See `.claude/skills/qe-browser/SKILL.md`.

<default_to_action>
When testing accessibility or ensuring compliance:
1. APPLY POUR principles: Perceivable, Operable, Understandable, Robust
2. TEST with keyboard-only navigation (Tab, Enter, Escape)
3. VALIDATE with screen readers (VoiceOver, NVDA, JAWS)
4. CHECK color contrast (4.5:1 for text, 3:1 for large text)
5. AUTOMATE with axe-core, integrate in CI/CD pipeline

**Quick A11y Checklist:**
- All images have alt text (or alt="" for decorative)
- All form fields have labels
- Color is never the only indicator
- Focus visible on all interactive elements
- Keyboard navigation works throughout

**Critical Success Factors:**
- Automated testing catches 30-50% of issues
- Manual testing with real assistive tech required
- Include users with disabilities in testing
</default_to_action>

## Quick Reference Card

### When to Use
- Legal compliance (ADA, Section 508, EU Directive)
- New feature development
- Before release validation
- Accessibility audits

### WCAG 2.2 Levels
| Level | Requirement | Target |
|-------|-------------|--------|
| **A** | Basic accessibility | Minimum legal |
| **AA** | Standard (most orgs) | Industry standard |
| **AAA** | Enhanced | Specialized sites |

### POUR Principles
| Principle | Meaning | Key Tests |
|-----------|---------|-----------|
| **Perceivable** | Can perceive content | Alt text, contrast, captions |
| **Operable** | Can operate UI | Keyboard, no seizures, navigation |
| **Understandable** | Can understand | Clear labels, predictable, errors |
| **Robust** | Works with assistive tech | Valid HTML, ARIA |

### Color Contrast Requirements
| Content | AA Ratio | AAA Ratio |
|---------|----------|-----------|
| Normal text | 4.5:1 | 7:1 |
| Large text (18pt+) | 3:1 | 4.5:1 |
| UI components | 3:1 | - |

---

## Keyboard Navigation Testing

```javascript
// Test all interactive elements reachable via keyboard
test('all interactive elements keyboard accessible', async ({ page }) => {
  await page.goto('/');

  const focusableElements = await page.$$('button, a, input, select, textarea, [tabindex]');

  for (const element of focusableElements) {
    await element.focus();
    const isFocused = await element.evaluate(el => document.activeElement === el);
    expect(isFocused).toBe(true);
  }
});

// Verify visible focus indicator
test('focus indicator visible', async ({ page }) => {
  await page.goto('/');
  await page.keyboard.press('Tab');

  const focusedElement = await page.locator(':focus');
  const outline = await focusedElement.evaluate(el =>
    getComputedStyle(el).outline
  );

  expect(outline).not.toBe('none');
});
```

---

## Automated Testing with axe-core

### Preferred: via the `a11y-ally` AQE skill (qe-browser + Vibium)

For new work, use the `a11y-ally` skill — it composes `qe-browser` (Vibium
WebDriver BiDi) with `axe-core`, `pa11y`, and Lighthouse and produces a
WCAG-tagged JSON report with remediation guidance. It avoids the 300MB
Playwright install and is already wired into the AQE fleet.

```bash
# Runs axe-core + pa11y + Lighthouse via qe-browser (Vibium) engine
aqe skill run a11y-ally -- --url https://example.com --wcag AA
```

### Fallback: Playwright + @axe-core/playwright

Keep this path when you have an existing Playwright suite and don't want to
introduce a second browser runner, or when you need Firefox/Safari coverage
that Vibium's Chrome-only BiDi backend can't provide today.

```javascript
import { test, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';

test('page has no accessibility violations', async ({ page }) => {
  await page.goto('/');

  const results = await new AxeBuilder({ page })
    .withTags(['wcag2a', 'wcag2aa', 'wcag22aa'])
    .analyze();

  expect(results.violations).toEqual([]);
});

// CI/CD integration
test('checkout flow accessible', async ({ page }) => {
  await page.goto('/checkout');

  const results = await new AxeBuilder({ page })
    .include('#checkout-form')
    .disableRules(['color-contrast']) // Fix in next sprint
    .analyze();

  expect(results.violations.filter(v =>
    v.impact === 'critical' || v.impact === 'serious'
  )).toHaveLength(0);
});
```

---

## Screen Reader Testing Checklist

```markdown
## VoiceOver (macOS) Testing
- [ ] Page title announced on load
- [ ] Headings hierarchy correct (h1 → h2 → h3)
- [ ] Landmarks present (nav, main, footer)
- [ ] Images have descriptive alt text
- [ ] Form labels read correctly
- [ ] Error messages announced
- [ ] Dynamic content updates announced (aria-live)
```

---

## Agent-Driven Accessibility

```typescript
// Comprehensive a11y validation
await Task("Accessibility Validation", {
  url: 'https://example.com/checkout',
  standard: 'WCAG2.2',
  level: 'AA',
  checks: ['keyboard', 'screen-reader', 'color-contrast'],
  includeScreenReaderSimulation: true
}, "qe-visual-tester");

// Fleet coordination for comprehensive testing
const a11yFleet = await FleetManager.coordinate({
  strategy: 'comprehensive-accessibility',
  agents: [
    'qe-visual-tester',     // Visual & keyboard checks
    'qe-test-generator',    // Generate a11y tests
    'qe-quality-gate'       // Enforce compliance
  ],
  topology: 'parallel'
});
```

---

## Agent Coordination Hints

### Memory Namespace
```
aqe/accessibility/
├── wcag-results/*       - WCAG audit results
├── screen-reader/*      - Screen reader test logs
├── remediation/*        - Fix recommendations
└── compliance/*         - Compliance reports
```

### Fleet Coordination
```typescript
const a11yFleet = await FleetManager.coordinate({
  strategy: 'accessibility-testing',
  agents: [
    'qe-visual-tester',   // axe-core, keyboard, focus
    'qe-test-generator',  // Generate a11y test cases
    'qe-quality-gate'     // Block non-compliant builds
  ],
  topology: 'parallel'
});
```

---

## Related Skills
- [visual-testing-advanced](../visual-testing-advanced/) - Visual a11y checks
- [mobile-testing](../mobile-testing/) - Mobile a11y (VoiceOver, TalkBack)
- [compliance-testing](../compliance-testing/) - Legal compliance

---

## Remember

**1 billion people have disabilities. Inaccessible software excludes 15% of humanity.** Legal requirements: ADA, Section 508, EU Directive 2016/2102. $13T purchasing power. 250%+ increase in lawsuits.

**Automated testing catches only 30-50% of issues.** Combine with manual keyboard testing, screen reader testing, and real user testing with people with disabilities.

**With Agents:** Agents automate WCAG 2.2 compliance checking, screen reader simulation, and focus management validation. Use agents to enforce accessibility standards in CI/CD and catch violations before production.

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

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

Все скиллы по теме «Тесты и QA» →

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

accessibility-testing kindlmann Скилл accessibility-testing для проверки доступности: гоняет axe-core через Playwright, аудит клавиатуры и экранных дикторов, разбор ARIA. CX Codex +1 1 500установок accessibility-testing aj-geddes Скилл accessibility-testing для Claude Code: проверяет веб-приложения на соответствие WCAG — axe, клавиатурная навигация, ARIA, скринридеры. Закрывает a11y-требования проекта. CX Codex +1 583установок accessibility-audit rampstackco Скилл accessibility-audit проводит аудит доступности интерфейса по стандарту WCAG 2.1 AA и формирует план исправления ошибок. Пригодится перед релизом и при подготовке к проверкам ADA или Section 508. CX Codex +1 364установок accessibility-agents Community Access (Jeff Bishop and Taylor Arndt) Плагин accessibility-agents для GitHub Copilot направляет задачи по доступности подходящим специалистам. Проверяет интерфейсы и документы на соответствие WCAG 2.2 AA и блокирует правки пользовательских файлов до проверки. ★ 453звёзд репо web-accessibility akillness Скилл web-accessibility классифицирует дефекты доступности веб-интерфейса, отсекает лишний ARIA-код и формирует чёткий план доработок с ручной проверкой. CX Codex +1 558установок include ghaida Скилл include внедряет правила доступности и требования стандарта WCAG 2.2 в интерфейсные решения до начала вёрстки. CX Codex +1 3 300установок a11y aladicf Скилл a11y для Claude Code разбирает интерфейс по клавиатуре, скринридеру, контрасту и семантике. Правит найденное, включая компоненты, не работающие без мыши. CX Codex +1 641установок better-accessibility jakubkrehel Скилл better-accessibility для Claude Code проверяет интерфейс по стандарту WCAG 2.2 и правит фокус, клавиатурную навигацию, формы и разметку ARIA под экранные дикторы. CX Codex +1 39 300установок

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

Весь набор →
qcsd-refinement-swarm Скилл qcsd-refinement-swarm проверяет пользовательские истории перед планированием спринта: оценивает требования, готовит BDD-сценарии и выносит решение о готовности. CX Codex +1 105установок qcsd-cicd-swarm Скилл qcsd-cicd-swarm для Claude Code проверяет CI/CD-пайплайн перед выпуском и оценивает готовность к развёртыванию. Анализирует регрессионные риски и нестабильные тесты, затем выносит решение: RELEASE, REMEDIATE или BLOCK. CX Codex +1 104установок test-idea-rewriting Скилл test-idea-rewriting переписывает пассивные формулировки тестов в активные действия с наблюдаемым результатом для Claude Code. Применяется при проверке качества и разборе тест-кейсов. CX Codex +1 104установок cicd-pipeline-qe-orchestrator Скилл cicd-pipeline-qe-orchestrator для Claude Code распределяет проверки качества по этапам CI/CD и помогает настроить блокирующие гейты. Он согласует тестирование от коммита до продакшена. CX Codex +1 1установок qe-visual-accessibility Скилл qe-visual-accessibility автоматизирует проверку доступности по стандарту WCAG 2.2 и находит сдвиги интерфейса по скриншотам. Помогает контролировать регрессии после правок стилей и компонентов. CX Codex +1 1установок exploratory-testing-advanced Скилл exploratory-testing-advanced для Claude Code помогает планировать исследовательские сессии, проверять гипотезы и фиксировать дефекты. Проверяет новые функции и риски, которые не ловят автоматические тесты. CX Codex +1 1установок compliance-testing Скилл compliance-testing проверяет соответствие приложения GDPR, CCPA, HIPAA, SOC2 и PCI-DSS; включается перед аудитом или при работе с персональными данными. CX Codex +1 1установок quality-metrics Скилл quality-metrics отслеживает метрики качества ПО: плотность дефектов, DORA, MTTD и bug escape rate для дашбордов и quality gates. CX Codex +1 1установок

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

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