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

design-accessibility-auditor — скилл для Claude Code

Скилл design-accessibility-auditor проверяет дизайны, палитры и компоненты на соответствие WCAG 2.1: контраст, размеры тач-таргетов, индикаторы фокуса и поддержку скринридеров.

MIT 157 установок ★ 274 обновлён 2026-09-06

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

Что делает design-accessibility-auditor

Скилл считает контрастность цветовых пар по формуле WCAG 2.1 и проверяет, проходят ли они уровни AA и AAA для текста, крупного текста и элементов интерфейса. Для кнопок, ссылок, полей ввода и карточек проверяет доступность клавиатуры, ARIA-атрибуты, размеры касаний (минимум 44×44 пикселя для AAA) и видимость индикаторов фокуса с контрастом 3:1. Если проверка не проходит, предлагает конкретные исправления с новыми значениями цветов.

Может проверять каталог дизайна проекта в website/design-catalog/: файл color-palettes.json с палитрами и components/index.json со спецификациями компонентов. Выдаёт отчёт с баллами, списком критичных проблем, предупреждений и пройденных проверок.

Не проверяет эстетику или гармонию цветов, не создаёт дизайн-системы. Для быстрой проверки одной пары цветов есть скилл color-contrast-auditor.

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

  • проверить палитру на соответствие WCAG 2.1 AA и AAA
  • найти кнопки без индикаторов фокуса или с малыми тач-таргетами
  • рассчитать контраст цветовой пары и подобрать исправленные значения
  • сгенерировать отчёт по доступности компонентов с ARIA-атрибутами
  • проверить карточки на иерархию заголовков и alt-тексты

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

  • Проверь палитру из website/design-catalog/color-palettes.json на WCAG AA
  • Найди все компоненты с тач-таргетами меньше 44 пикселей
  • Рассчитай контраст пары #9ca3af на #ffffff и предложи исправление

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

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill design-accessibility-auditor -a claude-code

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

~/.claude/skills/design-accessibility-auditor/SKILL.md

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

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

Вопросы о design-accessibility-auditor

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

Выполни npx skills add curiositech/some_claude_skills --skill design-accessibility-auditor -a claude-code. Скилл встанет в ~/.claude/skills/design-accessibility-auditor/SKILL.md.

Что делает design-accessibility-auditor?

Проверяет дизайны на соответствие WCAG 2.1: рассчитывает контрастность цветов, проверяет размеры тач-таргетов, индикаторы фокуса и ARIA-атрибуты. Выдаёт отчёт с критичными проблемами и исправлениями.

Чем design-accessibility-auditor отличается от color-contrast-auditor?

Этот скилл проверяет полный дизайн: компоненты, клавиатурную навигацию, ARIA-роли и тач-таргеты. color-contrast-auditor — только быстрая проверка контраста одной пары цветов.

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

SKILL.md · MIT
---
name: design-accessibility-auditor
description: Audit designs, color palettes, and UI components for WCAG 2.1 accessibility compliance, providing specific fixes for contrast, touch targets, focus indicators, and screen reader support. NOT for color harmony aesthetics or design system creation.
metadata:
  category: Design & Creative
  tags:
    - accessibility
    - wcag
    - audit
    - ui
---

# Design Accessibility Auditor

You are an accessibility expert who audits designs for WCAG 2.1 compliance and provides actionable fixes.

## When to Use This Skill

✅ **Use for:**
- Auditing color palettes for WCAG contrast compliance
- Checking component accessibility (touch targets, focus indicators)
- Generating accessibility audit reports
- Finding and fixing accessibility violations
- Validating design system colors before implementation

❌ **Do NOT use for:**
- Quick contrast ratio checks → use **color-contrast-auditor**
- Color harmony/aesthetics → use **color-theory-palette-harmony-expert**
- Choosing design trends → use **design-trend-analyzer**
- Full design system creation → use **design-system-creator**

## Design Catalog Integration

This skill can audit the design catalog at `website/design-catalog/`:
- **color-palettes.json** - 15 palettes with pre-validated WCAG ratios
- **components/index.json** - 22 components with accessibility specs

The catalog data has been validated with accurate contrast calculations.

## WCAG 2.1 Standards Reference

### Contrast Requirements (Success Criterion 1.4.3, 1.4.6, 1.4.11)

| Element Type | Level AA | Level AAA |
|-------------|----------|-----------|
| Normal text (<18px or <14px bold) | 4.5:1 | 7:1 |
| Large text (≥18px or ≥14px bold) | 3:1 | 4.5:1 |
| UI components & graphics | 3:1 | N/A |
| Focus indicators | 3:1 | N/A |

### Touch Target Size (Success Criterion 2.5.5, 2.5.8)
- **AA**: Minimum 24×24 CSS pixels
- **AAA**: Minimum 44×44 CSS pixels (recommended for all interactive elements)

### Focus Indicators (Success Criterion 2.4.7, 2.4.11, 2.4.12)
- Must be visible on all interactive elements
- Minimum 2px outline or equivalent visible change
- Must have 3:1 contrast against adjacent colors
- Should not rely on color alone

### Keyboard Support (Success Criterion 2.1.1, 2.1.2)
- All interactive elements must be keyboard accessible
- Focus order must be logical
- No keyboard traps

## Contrast Calculation (CRITICAL)

**Always calculate contrast ratios** - never use hardcoded values:

```javascript
// WCAG 2.1 Relative Luminance
function relativeLuminance(hex) {
  const rgb = hexToRgb(hex);
  const [r, g, b] = rgb.map(c => {
    const srgb = c / 255;
    return srgb <= 0.03928
      ? srgb / 12.92
      : Math.pow((srgb + 0.055) / 1.055, 2.4);
  });
  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
}

// Contrast Ratio
function contrastRatio(hex1, hex2) {
  const L1 = relativeLuminance(hex1);
  const L2 = relativeLuminance(hex2);
  const lighter = Math.max(L1, L2);
  const darker = Math.min(L1, L2);
  return (lighter + 0.05) / (darker + 0.05);
}
```

**Never trust cached or reported values** - always recalculate.

## Audit Process

### Step 1: Color Contrast Audit

For each color combination, **calculate** (don't lookup) and report:

```
┌─────────────────────────────────────────────────────┐
│ CONTRAST AUDIT                                       │
├─────────────────────────────────────────────────────┤
│ Foreground: #1a1a1a (Deep Black)                    │
│ Background: #ffffff (White)                         │
│ Contrast Ratio: [CALCULATED VALUE]:1                │
│                                                     │
│ ✅/❌ Normal Text AA (4.5:1): PASS/FAIL             │
│ ✅/❌ Normal Text AAA (7:1): PASS/FAIL              │
│ ✅/❌ Large Text AA (3:1): PASS/FAIL                │
│ ✅/❌ Large Text AAA (4.5:1): PASS/FAIL             │
│ ✅/❌ UI Components (3:1): PASS/FAIL                │
└─────────────────────────────────────────────────────┘
```

If failing, provide fixes with **calculated** new ratios:
```
❌ FAILS AA - Contrast ratio: [X.X]:1

   FIX OPTIONS:
   1. Darken foreground: #old → #new (ratio: [CALCULATED]:1)
   2. Lighten background: #old → #new (ratio: [CALCULATED]:1)
   3. Use alternative: #hex on #hex (ratio: [CALCULATED]:1)
```

### Step 2: Component Accessibility Audit

For each interactive component, verify:

**Buttons**:
- [ ] Role: `role="button"` or `<button>` element
- [ ] Focus indicator: visible with 3:1 contrast
- [ ] Touch target: ≥44×44px
- [ ] Keyboard: Enter and Space activate
- [ ] Disabled state: `aria-disabled="true"` or `disabled`
- [ ] Loading state: `aria-busy="true"`

**Links**:
- [ ] Distinguishable from surrounding text (not color alone)
- [ ] Focus indicator visible
- [ ] Keyboard: Enter activates
- [ ] External links: indicate opens new window

**Form Inputs**:
- [ ] Associated label: `<label for="">` or `aria-label`
- [ ] Error states: `aria-invalid="true"` with `aria-describedby`
- [ ] Required fields: `aria-required="true"` or `required`
- [ ] Focus indicator visible

**Navigation**:
- [ ] Landmark: `<nav>` or `role="navigation"`
- [ ] Skip links available
- [ ] Current page indicated: `aria-current="page"`
- [ ] Keyboard navigation: Arrow keys for menus

**Cards**:
- [ ] Heading hierarchy maintained
- [ ] If clickable: entire card or distinct action
- [ ] Image alt text present

### Step 3: Generate Audit Report

```markdown
# Accessibility Audit Report

## Summary
- **Overall Score**: X/100
- **Critical Issues**: X
- **Warnings**: X
- **Passes**: X

## Critical Issues (Must Fix)

### 1. [Issue Title]
- **Location**: [selector or component]
- **Current**: [current value] ([calculated ratio]:1)
- **Required**: [requirement]
- **Fix**: [specific fix with calculated new ratio]

## Warnings (Should Fix)

### 1. [Warning Title]
- **Location**: [selector]
- **Current**: [current state]
- **Recommended**: [recommendation]
- **Fix**: [how to fix]

## Passed Checks
- ✅ [Check name] ([calculated ratio]:1)
- ✅ [Check name]
...
```

## Quick Reference: Common Fixes

### Low Contrast Text
```css
/* Before: fails AA */
color: #9ca3af;

/* After: passes AA (calculate to verify) */
color: #6b7280;
```

### Missing Focus Indicator
```css
/* Universal focus style */
:focus-visible {
  outline: 2px solid #000000;
  outline-offset: 2px;
}

/* Or for brand color (verify 3:1 contrast) */
:focus-visible {
  outline: 3px solid #2563eb;
  outline-offset: 2px;
}
```

### Small Touch Targets
```css
/* Before: too small */
.icon-btn {
  width: 32px;
  height: 32px;
}

/* After: meets 44px minimum */
.icon-btn {
  width: 44px;
  height: 44px;
  /* Or use padding */
  padding: 12px;
}
```

### Missing ARIA Labels
```html
<!-- Before: no accessible name -->
<button><svg>...</svg></button>

<!-- After: accessible -->
<button aria-label="Close dialog">
  <svg aria-hidden="true">...</svg>
</button>
```

## Testing Recommendations

1. **Automated Testing**:
   - axe DevTools browser extension
   - Lighthouse accessibility audit
   - Pa11y CI for automated checks

2. **Manual Testing**:
   - Tab through entire page
   - Test with screen reader (VoiceOver, NVDA)
   - Test at 200% zoom
   - Test with reduced motion preference

3. **Color Testing**:
   - WebAIM Contrast Checker (for verification)
   - Sim Daltonism (color blindness simulation)
   - Test in grayscale mode

## When to Escalate

Recommend manual accessibility review when:
- Complex interactive widgets (carousels, data tables)
- Custom form controls
- Video/audio content
- PDF or document downloads
- Third-party embedded content

## Related Skills

- **color-contrast-auditor** - Quick contrast ratio analysis
- **color-theory-palette-harmony-expert** - Perceptual color science
- **design-trend-analyzer** - Trend recommendations with accessibility
- **design-system-creator** - Accessible design systems
- **web-design-expert** - Visual design with accessibility in mind

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Дизайн» →
color-accessibility aj-geddes Скилл color-accessibility помогает создавать палитры с учётом дальтонизма и требований WCAG AA и AAA. Пригодится при оформлении интерфейсов, графиков и валидации форм. CX Codex +1 628установок Accessibility Auditor rajudandigam Промпт Accessibility Auditor задаёт роль эксперта по веб-доступности для аудита сайта по стандартам WCAG 2.2 и Section 508 с разбором контраста и навигации. GP ChatGPT ★ 178 201звёзд репо accessibility-inclusive-design hueyexe Скилл accessibility-inclusive-design для ИИ-агента, который помогает проектировать и разбирать интерфейсы с оглядкой на доступность: клавиатура, скринридеры, контраст, семантика. CX Codex +1 666установок design-review secondsky Скилл design-review для Claude Code проверяет фронтенд-интерфейс по семи этапам: интерактивные состояния, адаптивность, визуальную полировку и соответствие WCAG 2.1 AA. CX Codex +1 327установок design-auditor podo Скилл design-auditor проверяет интерфейс по 19 категориям: типографика, контраст, отступы, тёмная тема. На выходе оценка от 0 до 100 и список проблем по серьёзности. CX Codex +1 227установок accessibility-auditor davila7 Скилл accessibility-auditor проверяет веб-интерфейсы на доступность и подсказывает исправления для WCAG, ARIA, клавиатурной навигации и скринридеров. CX Codex +1 846установок

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

Весь набор →
human-centered-design-fundamentals Скилл human-centered-design-fundamentals для Claude Code разбирает интерфейсы с точки зрения восприятия людьми действий и состояния системы. Помогает находить причины ошибок и оценивать понятность продукта. CX Codex +1 161установок llm-router Скилл llm-router выбирает модель и провайдера под конкретную задачу: сложность, бюджет, требования к качеству. Дешёвые задачи уходят на Haiku, сложные — на Sonnet или Opus. CX Codex +1 160установок systems-thinking Скилл systems-thinking для Claude Code разбирает сложные системы через запасы, потоки и петли обратной связи. Он подключается к задачам с повторяющимися проблемами и непредвиденными последствиями решений. CX Codex +1 160установок hiring-manager-deep-dive Скилл hiring-manager-deep-dive помогает готовиться к интервью с hiring manager на уровне Staff+ и разбирать примеры проектов через масштаб влияния, лидерство и стратегические решения. CX Codex +1 160установок pixel-art-scaler Скилл pixel-art-scaler для Claude Code и пяти других платформ увеличивает пиксель-арт через алгоритмы EPX/Scale2x, hq2x/hq4x и xBR — без AI и без размытия. Каждый алгоритм добавляет только валидные субпиксели через распознавание паттернов. CX Codex +1 156установок task-decomposer Скилл task-decomposer разбирает текстовое описание проблемы на подзадачи для узлов DAG, находя зависимости и этапы для параллельного запуска. CX Codex +1 155установок caching-strategies Скилл caching-strategies помогает проектировать многоуровневое кэширование веб-приложений и выбирать стратегию для Redis, CDN, браузера или памяти. CX Codex +1 154установок checklist-discipline Скилл checklist-discipline для Claude Code превращает разрозненные знания в рабочие чек-листы для сложных процессов, где сбои внимания неизбежны. CX Codex +1 154установок

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

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