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

Accessibility Engineer — скилл для Claude Code

Скилл Accessibility Engineer помогает проектировать доступные интерфейсы и проверять их на соответствие WCAG 2.1 AA. Пригодится при разработке UI и аудите доступности.

MIT 181 установок ★ 39 обновлён 2025-12-25

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

Что делает Accessibility Engineer

Скилл подсказывает, как строить интерфейс на семантическом HTML, сохранять естественный порядок перехода клавишей Tab и управлять фокусом в модальных окнах. В руководстве есть примеры для ссылок пропуска навигации и доступных элементов управления.

Отдельные разделы посвящены атрибутам ARIA и формам: меткам полей, сообщениям об ошибках и обязательным значениям. ARIA стоит добавлять, когда семантического HTML недостаточно; лишний role="button" на кнопке здесь приведён как плохой пример.

Скилл также задаёт цель WCAG 2.1 AA.

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

  • выстроить заголовки и области страницы семантически
  • сделать интерактивные элементы доступными с клавиатуры
  • настроить фокус при открытии модального окна
  • связать поля формы с метками и ошибками
  • подобрать ARIA-атрибуты для динамического содержимого

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

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

Как установить Accessibility Engineer

1Через Skills CLI (Vercel)

npx skills add daffy0208/ai-dev-standards --skill accessibility-engineer -a claude-code

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

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

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

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

Вопросы об Accessibility Engineer

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

Выполните npx skills add daffy0208/ai-dev-standards --skill accessibility-engineer -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/accessibility-engineer/SKILL.md.

Что делает Accessibility Engineer?

Скилл даёт рекомендации по доступной разметке, клавиатурной навигации, ARIA и формам. Он ориентирует на WCAG 2.1 AA.

Как скилл советует использовать ARIA?

Добавлять ARIA следует, когда возможностей семантического HTML недостаточно. Например, для пользовательского элемента вкладки приводятся role="tab", aria-selected и aria-controls.

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

SKILL.md · MIT
---
name: Accessibility Engineer
description: Implement accessibility (a11y) best practices to make applications usable by everyone. Use when building UIs, conducting accessibility audits, or ensuring WCAG compliance. Covers screen readers, keyboard navigation, ARIA attributes, and inclusive design patterns.
version: 1.0.0
---

# Accessibility Engineer

Build for everyone - accessibility is not optional.

## Core Principle

**Accessibility is a civil right, not a feature.**

1 in 4 adults in the US has a disability. Accessible design benefits everyone:

- Blind users (screen readers)
- Low vision users (zoom, high contrast)
- Deaf users (captions)
- Motor disabilities (keyboard-only)
- Cognitive disabilities (clear language)
- Temporary disabilities (broken arm)
- Situational limitations (bright sunlight, noisy environment)

## WCAG Compliance Levels

**Level A:** Minimum (legal requirement)
**Level AA:** Industry standard (aim for this)
**Level AAA:** Gold standard (difficult to achieve for all content)

**Target: WCAG 2.1 AA compliance**

---

## Pillar 1: Semantic HTML

### Use the Right Elements

```jsx
// ❌ Bad: Divs for everything (no semantic meaning)
<div onClick={handleClick}>Click me</div>
<div>Menu</div>

// ✅ Good: Semantic HTML
<button onClick={handleClick}>Click me</button>
<nav>Menu</nav>
```

### Document Structure

```jsx
// ✅ Proper heading hierarchy
<h1>Page Title</h1>
  <h2>Section 1</h2>
    <h3>Subsection 1.1</h3>
  <h2>Section 2</h2>

// ❌ Bad: Skipping levels
<h1>Page Title</h1>
  <h4>Section 1</h4> // Skipped h2, h3
```

### Landmarks

```jsx
<header>
  <nav aria-label="Main navigation">
    {/* Navigation links */}
  </nav>
</header>

<main>
  <article>
    {/* Main content */}
  </article>

  <aside>
    {/* Sidebar */}
  </aside>
</main>

<footer>
  {/* Footer content */}
</footer>
```

---

## Pillar 2: Keyboard Navigation

### All Interactive Elements Must Be Keyboard Accessible

```jsx
// ✅ Button is keyboard accessible by default
<button onClick={handleClick}>Click me</button>

// ❌ Div requires extra work
<div onClick={handleClick}>Click me</div> // Can't tab to it!

// ✅ If you must use div, add keyboard support
<div
  role="button"
  tabIndex={0}
  onClick={handleClick}
  onKeyDown={(e) => {
    if (e.key === 'Enter' || e.key === ' ') {
      handleClick()
    }
  }}
>
  Click me
</div>
```

### Tab Order

```jsx
// ✅ Natural tab order (follows DOM order)
<input />
<button>Submit</button>
<a href="/help">Help</a>

// ❌ Don't use tabIndex > 0 (breaks natural order)
<button tabIndex={5}>Button</button> // Anti-pattern!

// ✅ tabIndex=-1 to remove from tab order
<div tabIndex={-1}>Not keyboard focusable</div>
```

### Focus Management

```jsx
// Modal: Trap focus inside
function Modal({ isOpen, onClose, children }) {
  const modalRef = useRef()

  useEffect(() => {
    if (!isOpen) return

    // Focus first focusable element
    const firstFocusable = modalRef.current.querySelector('button, input, a')
    firstFocusable?.focus()

    // Trap focus
    function handleTab(e) {
      if (e.key !== 'Tab') return

      const focusableElements = modalRef.current.querySelectorAll(
        'button, input, a, [tabindex]:not([tabindex="-1"])'
      )

      const first = focusableElements[0]
      const last = focusableElements[focusableElements.length - 1]

      if (e.shiftKey) {
        if (document.activeElement === first) {
          last.focus()
          e.preventDefault()
        }
      } else {
        if (document.activeElement === last) {
          first.focus()
          e.preventDefault()
        }
      }
    }

    document.addEventListener('keydown', handleTab)
    return () => document.removeEventListener('keydown', handleTab)
  }, [isOpen])

  return isOpen ? (
    <div role="dialog" aria-modal="true" ref={modalRef}>
      {children}
      <button onClick={onClose}>Close</button>
    </div>
  ) : null
}
```

### Skip Links

```jsx
// Allow keyboard users to skip navigation
<a href="#main-content" className="skip-link">
  Skip to main content
</a>

<nav>{/* Navigation */}</nav>

<main id="main-content">
  {/* Main content */}
</main>

// CSS
.skip-link {
  position: absolute;
  top: -40px;
  left: 0;
  background: #000;
  color: #fff;
  padding: 8px;
}

.skip-link:focus {
  top: 0;
}
```

---

## Pillar 3: ARIA Attributes

### Only Use ARIA When Semantic HTML Isn't Enough

```jsx
// ✅ Semantic HTML (no ARIA needed)
<button>Click me</button>

// ❌ Unnecessary ARIA
<button role="button" aria-label="Click me">Click me</button>

// ✅ ARIA needed (custom widget)
<div role="tab" aria-selected={isActive} aria-controls="panel-1">
  Tab 1
</div>
```

### Common ARIA Attributes

**aria-label** - Provides accessible name:

```jsx
<button aria-label="Close dialog">
  <XIcon /> {/* Visual only */}
</button>

<input type="search" aria-label="Search products" />
```

**aria-labelledby** - References another element:

```jsx
<h2 id="dialog-title">Delete Account</h2>
<div role="dialog" aria-labelledby="dialog-title">
  {/* Dialog content */}
</div>
```

**aria-describedby** - Additional description:

```jsx
<input
  type="password"
  aria-describedby="password-requirements"
/>
<div id="password-requirements">
  Must be at least 8 characters
</div>
```

**aria-live** - Announce dynamic content:

```jsx
// Polite: Wait for user to finish
<div aria-live="polite">
  {itemsAddedToCart} items added to cart
</div>

// Assertive: Interrupt immediately (use sparingly)
<div aria-live="assertive" role="alert">
  Error: Payment failed
</div>
```

**aria-expanded** - Collapsible content:

```jsx
<button
  aria-expanded={isOpen}
  aria-controls="dropdown-menu"
  onClick={() => setIsOpen(!isOpen)}
>
  Menu
</button>

<div id="dropdown-menu" hidden={!isOpen}>
  {/* Menu items */}
</div>
```

**aria-hidden** - Hide from screen readers:

```jsx
// Decorative icons
<span aria-hidden="true">★</span>

// Don't hide interactive elements!
// ❌ Bad
<button aria-hidden="true">Click me</button>
```

---

## Pillar 4: Forms & Inputs

### Labels

```jsx
// ✅ Good: Explicit label
<label htmlFor="email">Email</label>
<input id="email" type="email" />

// ✅ Good: Implicit label
<label>
  Email
  <input type="email" />
</label>

// ❌ Bad: No label (placeholder is not a label!)
<input type="email" placeholder="Email" />
```

### Error Messages

```jsx
function EmailInput({ error }) {
  const errorId = 'email-error'

  return (
    <>
      <label htmlFor="email">Email</label>
      <input
        id="email"
        type="email"
        aria-invalid={!!error}
        aria-describedby={error ? errorId : undefined}
      />
      {error && (
        <div id={errorId} role="alert">
          {error}
        </div>
      )}
    </>
  )
}
```

### Required Fields

```jsx
<label htmlFor="name">
  Name <span aria-label="required">*</span>
</label>
<input id="name" type="text" required aria-required="true" />
```

---

## Pillar 5: Color & Contrast

### Minimum Contrast Ratios (WCAG AA)

- Normal text (< 18pt): 4.5:1
- Large text (≥ 18pt or 14pt bold): 3:1
- UI components: 3:1

```jsx
// ❌ Bad: Insufficient contrast
<button style={{ background: '#ddd', color: '#aaa' }}>
  Submit // 1.5:1 contrast - fails!
</button>

// ✅ Good: Sufficient contrast
<button style={{ background: '#0066cc', color: '#ffffff' }}>
  Submit // 8:1 contrast - passes!
</button>
```

### Don't Use Color Alone

```jsx
// ❌ Bad: Color only
<span style={{ color: 'red' }}>Error</span>
<span style={{ color: 'green' }}>Success</span>

// ✅ Good: Color + icon/text
<span style={{ color: 'red' }}>
  <ErrorIcon aria-hidden="true" />
  Error
</span>
```

---

## Pillar 6: Images & Media

### Alt Text

```jsx
// ✅ Informative images
<img src="chart.png" alt="Sales increased 50% in Q4" />

// ✅ Decorative images
<img src="decorative-border.png" alt="" /> // Empty alt

// ❌ Bad: No alt or redundant alt
<img src="photo.jpg" /> // Missing alt
<img src="photo.jpg" alt="Photo" /> // Useless
```

### Complex Images

```jsx
<figure>
  <img src="complex-chart.png" alt="Sales data for 2024" />
  <figcaption>
    <details>
      <summary>Detailed description</summary>
      <p>Q1: $100k, Q2: $150k, Q3: $180k, Q4: $220k. Shows 50% growth year-over-year.</p>
    </details>
  </figcaption>
</figure>
```

### Video Captions

```jsx
<video controls>
  <source src="video.mp4" type="video/mp4" />
  <track kind="captions" src="captions.vtt" srclang="en" label="English" default />
</video>
```

---

## Pillar 7: Testing

### Automated Testing

```bash
# Lighthouse accessibility audit
lighthouse https://example.com --only-categories=accessibility

# axe-core (Jest)
npm install --save-dev @axe-core/react jest-axe
```

```typescript
// Test with jest-axe
import { axe, toHaveNoViolations } from 'jest-axe'

expect.extend(toHaveNoViolations)

it('has no accessibility violations', async () => {
  const { container } = render(<Button>Click me</Button>)
  const results = await axe(container)

  expect(results).toHaveNoViolations()
})
```

### Manual Testing

**Keyboard Navigation:**

- Tab through entire page
- Enter/Space to activate buttons
- Arrow keys for radio groups
- Esc to close modals

**Screen Reader Testing:**

- **NVDA** (Windows, free)
- **JAWS** (Windows, paid)
- **VoiceOver** (Mac, built-in)

**Screen Reader Shortcuts:**

- Navigate by headings: H (next), Shift+H (previous)
- Navigate by landmarks: D (next), Shift+D (previous)
- List all links: Insert+F7 (NVDA)

---

## Common Patterns

### Accessible Button

```jsx
<button
  type="button"
  onClick={handleClick}
  disabled={isDisabled}
  aria-busy={isLoading}
  aria-label={ariaLabel}
>
  {children}
</button>
```

### Accessible Modal

```jsx
<div
  role="dialog"
  aria-modal="true"
  aria-labelledby="dialog-title"
  aria-describedby="dialog-description"
>
  <h2 id="dialog-title">Dialog Title</h2>
  <p id="dialog-description">Dialog description</p>

  <button onClick={onClose}>Close</button>
</div>
```

### Accessible Tabs

```jsx
<div>
  <div role="tablist">
    <button
      role="tab"
      aria-selected={activeTab === 'tab1'}
      aria-controls="panel1"
      onClick={() => setActiveTab('tab1')}
    >
      Tab 1
    </button>
    <button
      role="tab"
      aria-selected={activeTab === 'tab2'}
      aria-controls="panel2"
      onClick={() => setActiveTab('tab2')}
    >
      Tab 2
    </button>
  </div>

  <div id="panel1" role="tabpanel" hidden={activeTab !== 'tab1'}>
    Panel 1 content
  </div>

  <div id="panel2" role="tabpanel" hidden={activeTab !== 'tab2'}>
    Panel 2 content
  </div>
</div>
```

---

## Accessibility Checklist

### Semantic HTML

- [ ] Proper heading hierarchy (h1 → h2 → h3)
- [ ] Semantic landmarks (header, nav, main, footer)
- [ ] Lists use ul/ol/li
- [ ] Buttons for actions, links for navigation

### Keyboard

- [ ] All interactive elements keyboard accessible
- [ ] Visible focus indicators
- [ ] Logical tab order
- [ ] Skip links provided
- [ ] No keyboard traps

### ARIA

- [ ] Semantic HTML used first (ARIA only when needed)
- [ ] All interactive widgets have roles
- [ ] Dynamic content has aria-live
- [ ] Forms have proper labels and descriptions

### Color & Contrast

- [ ] Text contrast ≥ 4.5:1 (normal), ≥ 3:1 (large)
- [ ] Don't use color alone to convey info
- [ ] Focus indicators visible

### Images & Media

- [ ] All images have alt text
- [ ] Decorative images have empty alt
- [ ] Videos have captions
- [ ] Audio has transcripts

### Forms

- [ ] All inputs have labels
- [ ] Error messages associated with inputs
- [ ] Required fields indicated

### Testing

- [ ] Keyboard navigation tested
- [ ] Screen reader tested
- [ ] Automated tools run (axe, Lighthouse)
- [ ] Color blindness simulation tested

---

## Tools

- **axe DevTools** - Browser extension
- **Lighthouse** - Built into Chrome DevTools
- **WAVE** - Web accessibility evaluation tool
- **Color Contrast Analyzer** - Desktop app
- **NVDA** - Free screen reader (Windows)
- **VoiceOver** - Built-in screen reader (Mac)

---

## Related Resources

**Skills:**

- `ux-designer` - Accessible design patterns
- `frontend-builder` - Accessible React components
- `testing-strategist` - Accessibility testing

**External:**

- [WCAG 2.1 Guidelines](https://www.w3.org/WAI/WCAG21/quickref/)
- [MDN Accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility)
- [A11y Project](https://www.a11yproject.com/)
- [WebAIM](https://webaim.org/)

---

**Build for everyone.** ♿

© daffy0208 · MIT · daffy0208/ai-dev-standards

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

Все скиллы по теме «Фронтенд и UI» →
accessibility web-quality-skills Скилл accessibility для Claude Code проводит аудит доступности веб-страницы и указывает, что исправить в исходниках. Закрывает WCAG 2.2, проверку клавиатуры и скринридера. CX Codex +1 72 600установок better-accessibility jakubkrehel Скилл better-accessibility для Claude Code проверяет интерфейс по стандарту WCAG 2.2 и правит фокус, клавиатурную навигацию, формы и разметку ARIA под экранные дикторы. CX Codex +1 39 300установок fixing-accessibility ibelick Скилл fixing-accessibility для Claude Code проверяет HTML на проблемы доступности и предлагает точечные исправления. Проверяет формы, диалоги и интерактивные элементы. CX Codex +1 24 300установок accessibility-compliance Seth Hobson Скилл accessibility-compliance для Claude Code помогает создавать интерфейсы по стандарту WCAG 2.2. Запускается при проведении аудита доступности и внедрении ARIA-паттернов. CX Codex +1 14 596установок pixijs-accessibility pixijs Скилл pixijs-accessibility настраивает поддержку скринридеров и навигацию с клавиатуры в PixiJS v8 через оверлей shadow DOM. CX Codex +1 6 700установок event-accessibility-inclusion Samuel Berthe Скилл event-accessibility-inclusion помогает определить, какие условия доступности заложить в техническое мероприятие, как их описать публично и кто за них отвечает. Пригодится при планировании конференции или ответа на запрос участника. CX Codex +1 6 600установок

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

Весь набор →
RAG Implementer Скилл RAG Implementer ведёт агента через восемь фаз внедрения RAG: дизайн базы знаний, эмбеддинги, векторное хранилище, поисковый конвейер. Первым делом проверяет, нужен ли RAG вашему проекту. CX Codex +1 189установок usability-tester Скилл usability-tester помогает спланировать юзабилити-тест, составить реалистичные сценарии заданий и оценить серьёзность найденных проблем UX. CX Codex +1 188установок Supabase Developer Скилл Supabase Developer помогает проектировать базы данных с RLS, настраивать авторизацию, хранилище и Edge Functions на Supabase. CX Codex +1 187установок voice-interface-builder Скилл voice-interface-builder для Claude Code помогает добавлять в веб-интерфейс распознавание речи, голосовые команды и озвучивание текста. Включается при работе над голосовым управлением и доступностью. CX Codex +1 187установок forensic-data-engineer Скилл forensic-data-engineer для Claude Code помогает разбирать инциденты по данным: аномалии транзакций, аудит-логи и следы утечки. Выясняет, что и кто менял в базе. CX Codex +1 181установок data-engineer Скилл data-engineer помогает проектировать пайплайны данных, настраивать пакетный или потоковый ETL и готовить агрегаты для аналитики. CX Codex +1 181установок pricing-strategist Скилл pricing-strategist помогает назначить цену SaaS-продукта: выбрать метрику ценности, собрать тарифы, разложить по ним фичи и проверить гипотезы на A/B-тесте. CX Codex +1 180установок Testing Strategist Скилл Testing Strategist раскладывает тесты по пирамиде 70/20/10 и показывает на примерах Jest и React Testing Library, что писать на каждом уровне. CX Codex +1 176установок

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

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