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

accessibility-wcag — скилл для Claude Code

Скилл accessibility-wcag для Claude Code собирает шаблоны WCAG 2.2 для настройки семантической вёрстки, ARIA-атрибутов, управления с клавиатуры и контрастности.

Apache-2.0 ★ 2 858 обновлён 2026-05-12

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

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

Скилл добавляет в контекст правила веб-доступности по стандарту WCAG 2.2 AA. Внутри собраны готовые шаблоны для семантических ориентиров вроде <main> или <nav>, а также компоненты React: модальные окна с обработкой клавиши Escape и вкладки с навигацией по стрелкам.

В наборе расписана разметка форм с привязкой меток, текстов ошибок через role="alert" и вспомогательных описаний через aria-describedby. Отдельный блок задаёт требования к контрасту текста — 4.5:1 для обычного и 3:1 для крупного шрифта.

Без видимого индикатора фокуса в стилях интерфейс не пройдёт проверку доступности. Скилл запрещает убирать аутлайн без замены и не позволяет передавать статус ошибки только цветом.

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

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

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

  • Сделай этот компонент вкладок доступным для скринридеров и добавь переключение стрелками.
  • Проверь форму регистрации на соответствие WCAG 2.2 и привяжи role="alert" к ошибкам.
  • Настрой стили :focus-visible и проверь контрастность кнопок.

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

1Через Skills CLI (Vercel)

npx skills add rohitg00/awesome-claude-code-toolkit --skill accessibility-wcag -a claude-code

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

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

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

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

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

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

Выполните команду npx skills add rohitg00/awesome-claude-code-toolkit --skill accessibility-wcag -a claude-code. Также можно сохранить файл вручную по пути ~/.claude/skills/accessibility-wcag/SKILL.md.

Что делает скилл accessibility-wcag?

Он предоставляет агенту готовые примеры доступной вёрстки и чеклист требований WCAG 2.2. Агент опирается на них при написании компонентов, форм и клавиатурных обработчиков.

Какие требования к контрастности содержит этот скилл?

Скилл задаёт соотношение контраста 4.5:1 для основного текста и 3:1 для крупного шрифта. Он требует обязательный видимый контур фокуса.

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

SKILL.md · Apache-2.0
---
name: accessibility-wcag
description: Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing
---

# Accessibility & WCAG

## Semantic HTML

```html
<!-- Use semantic elements instead of generic divs -->
<header>
  <nav aria-label="Main navigation">
    <ul>
      <li><a href="/" aria-current="page">Home</a></li>
      <li><a href="/products">Products</a></li>
      <li><a href="/about">About</a></li>
    </ul>
  </nav>
</header>

<main>
  <article>
    <h1>Product Details</h1>
    <section aria-labelledby="specs-heading">
      <h2 id="specs-heading">Specifications</h2>
      <dl>
        <dt>Weight</dt>
        <dd>1.2 kg</dd>
        <dt>Dimensions</dt>
        <dd>30 x 20 x 10 cm</dd>
      </dl>
    </section>
  </article>
</main>

<footer>
  <p>&copy; 2024 Company Name</p>
</footer>
```

Use `<nav>`, `<main>`, `<article>`, `<section>`, `<aside>` instead of `<div>` for landmarks. Screen readers use these to navigate the page.

## ARIA Patterns

```tsx
function Modal({ isOpen, onClose, title, children }) {
  if (!isOpen) return null;

  return (
    <div
      role="dialog"
      aria-modal="true"
      aria-labelledby="modal-title"
      onKeyDown={(e) => e.key === "Escape" && onClose()}
    >
      <h2 id="modal-title">{title}</h2>
      <div>{children}</div>
      <button onClick={onClose} aria-label="Close dialog">
        <XIcon aria-hidden="true" />
      </button>
    </div>
  );
}

function Tabs({ tabs, activeIndex, onChange }) {
  return (
    <div>
      <div role="tablist" aria-label="Settings sections">
        {tabs.map((tab, i) => (
          <button
            key={tab.id}
            role="tab"
            id={`tab-${tab.id}`}
            aria-selected={i === activeIndex}
            aria-controls={`panel-${tab.id}`}
            tabIndex={i === activeIndex ? 0 : -1}
            onClick={() => onChange(i)}
            onKeyDown={(e) => handleArrowKeys(e, i, tabs.length, onChange)}
          >
            {tab.label}
          </button>
        ))}
      </div>
      {tabs.map((tab, i) => (
        <div
          key={tab.id}
          role="tabpanel"
          id={`panel-${tab.id}`}
          aria-labelledby={`tab-${tab.id}`}
          hidden={i !== activeIndex}
          tabIndex={0}
        >
          {tab.content}
        </div>
      ))}
    </div>
  );
}
```

## Keyboard Navigation

```tsx
function handleArrowKeys(
  event: React.KeyboardEvent,
  currentIndex: number,
  totalItems: number,
  onSelect: (index: number) => void
) {
  let newIndex = currentIndex;

  switch (event.key) {
    case "ArrowRight":
    case "ArrowDown":
      newIndex = (currentIndex + 1) % totalItems;
      break;
    case "ArrowLeft":
    case "ArrowUp":
      newIndex = (currentIndex - 1 + totalItems) % totalItems;
      break;
    case "Home":
      newIndex = 0;
      break;
    case "End":
      newIndex = totalItems - 1;
      break;
    default:
      return;
  }

  event.preventDefault();
  onSelect(newIndex);
}
```

All interactive elements must be reachable via keyboard. Tab for focus navigation, Enter/Space for activation, Arrow keys for within-component navigation.

## Form Accessibility

```tsx
function SignupForm() {
  return (
    <form aria-labelledby="form-title" noValidate>
      <h2 id="form-title">Create Account</h2>

      <div>
        <label htmlFor="email">Email address</label>
        <input
          id="email"
          type="email"
          required
          aria-required="true"
          aria-describedby="email-hint email-error"
          aria-invalid={hasError ? "true" : undefined}
        />
        <p id="email-hint">We will never share your email.</p>
        {hasError && (
          <p id="email-error" role="alert">
            Please enter a valid email address.
          </p>
        )}
      </div>

      <button type="submit">Create Account</button>
    </form>
  );
}
```

## Color and Contrast

```css
:root {
  --text-primary: #1a1a1a;      /* 15.3:1 on white */
  --text-secondary: #595959;    /* 7.0:1 on white */
  --text-on-primary: #ffffff;   /* Ensure 4.5:1 on brand color */
  --border-focus: #0066cc;      /* Visible focus ring */
}

*:focus-visible {
  outline: 3px solid var(--border-focus);
  outline-offset: 2px;
}

.error-message {
  color: #d32f2f;
  /* Don't rely on color alone - add icon or text prefix */
}
.error-message::before {
  content: "Error: ";
  font-weight: bold;
}
```

WCAG AA requires 4.5:1 contrast for normal text, 3:1 for large text (18px bold or 24px regular).

## Anti-Patterns

- Using `div` and `span` for clickable elements instead of `button` or `a`
- Removing focus outlines without providing an alternative indicator
- Relying on color alone to convey information (red for error, green for success)
- Using `aria-label` when visible text already labels the element
- Auto-playing media without a pause mechanism
- Missing skip navigation link for keyboard users

## Checklist

- [ ] All interactive elements keyboard-accessible (Tab, Enter, Escape, Arrows)
- [ ] Semantic HTML landmarks used (`nav`, `main`, `article`, `section`)
- [ ] Images have descriptive `alt` text (or `alt=""` for decorative)
- [ ] Color contrast meets WCAG AA (4.5:1 normal text, 3:1 large text)
- [ ] Focus indicators visible on all interactive elements
- [ ] Form inputs have associated `<label>` elements
- [ ] Error messages announced to screen readers via `role="alert"`
- [ ] Page tested with screen reader (VoiceOver, NVDA) and keyboard only

© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit

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

Все скиллы по теме «Фронтенд и UI» →
accessibility-a11y travisjneuman Скилл accessibility-a11y для Claude Code и Codex помогает внедрять стандарты WCAG 2.2 и проверять интерфейсы на доступность. Включается при создании UI-компонентов, аудите вёрстки или интеграции тестов в CI/CD. CX Codex +1 161установок accessibility maxtrigify Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG. CX Codex +1 ★ 141звёзд репо accessibility-compliance aj-geddes Скилл accessibility-compliance помогает внедрять требования WCAG 2.1/2.2, клавиатурную навигацию и поддержку программ чтения с экрана. CX Codex +1 490установок wcag-accessibility dembrandt Скилл wcag-accessibility помогает проектировать и проверять интерфейсы по WCAG 2.2 AA. Подключайте его при работе над доступностью компонентов и страниц. CX Codex +1 1 100установок accessibility-auditor OneWave-AI Скилл accessibility-auditor проводит аудит доступности веб-страниц по стандартам WCAG 2.1 AA. Он находит дефекты вёрстки, проверяет навигацию с клавиатуры и помогает исправить разметку. CX Codex +1 346установок accessibility-fix AccessLint Скилл accessibility-fix чинит нарушения веб-доступности по WCAG 2.2: снимает базовую линию, правит файлы, проверяет результат. Механические фиксы применяет сам, для остального ставит TODO. CX Codex +1 1 200установок

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

Весь набор →
developer-portal Субагент developer-portal для построения внутренних портальных решений на базе Backstage с каталогом сервисов, шаблонами проектов и самообслуживанием инфраструктуры. Ускоряет поиск сервисов, документации и развёртывание новых проектов. CX Codex ★ 2 858звёзд репо websocket-realtime Скилл websocket-realtime обучает Claude Code архитектуре реального времени: от чистого WebSocket и Socket.io до Server-Sent Events и связки с Redis. CX Codex +1 ★ 2 858звёзд репо monitoring-observability Скилл monitoring-observability для Claude Code добавляет в Node.js-сервис трассировки, метрики, структурированные логи и правила оповещений. Связывает сигналы приложения с дашбордами и SLO. CX Codex +1 ★ 2 858звёзд репо database-optimizer Субагент database-optimizer разбирает медленные запросы, строит индексы, настраивает партиционирование и планирует нагрузку для PostgreSQL, MySQL и распределённых баз. CX Codex ★ 2 858звёзд репо content-strategist Субагент content-strategist планирует SEO-контент, собирает темы в кластеры и помогает связать публикации с метриками. Подходит для технических продуктов и developer-аудитории. CX Codex ★ 2 858звёзд репо authentication-patterns Скилл authentication-patterns для Claude Code содержит паттерны аутентификации и авторизации: JWT, OAuth2 с PKCE, RBAC и middleware. Используйте при разработке защищённого бэкенда. CX Codex +1 ★ 2 858звёзд репо real-estate-tech Субагент real-estate-tech проектирует PropTech-платформы: интеграцию с MLS, геопоиск в PostGIS, оценку недвижимости и пайплайны листингов. Помогает при разработке систем поиска и сделок с жильём. CX Codex ★ 2 858звёзд репо error-coordinator Субагент error-coordinator координирует обработку ошибок в цепочках агентов: выбирает повтор, fallback или эскалацию и сохраняет контекст сбоя. CX Codex ★ 2 858звёзд репо

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

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