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

token-contrast-auditor — скилл для Claude Code: проверка контрастности

Скилл token-contrast-auditor для Claude Code проверяет соответствие цветовых пар стандартам WCAG. Запускается при анализе дизайн-токенов и стилей в коде проекта.

MIT ★ 529 обновлён 2026-11-17

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

Что делает token-contrast-auditor

Этот инструмент высчитывает коэффициент контрастности между парами цветов, используемыми в качестве текста и фона. Скилл анализирует как явно объявленные роли токенов, так и CSS-правила, где цвет текста и фон заданы вместе. Проверка основывается на математическом расчёте отношения яркости, что позволяет объективно оценить читаемость интерфейса.

Результат разделяется на три группы: провал, частичное соответствие для крупного текста и успешное прохождение уровня AA по стандарту WCAG 2.2. Скилл не делает выводов об исправлении, а предоставляет отчёт с коэффициентами и источниками пар, чтобы разработчик вручную выбрал способ адаптации. Цвета с альфа-каналом автоматически пропускаются, так как их итоговый вид зависит от подложки.

Для работы требуется наличие дизайн-системы с цветовыми токенами и доступ к файлам стилей. Инструмент не проводит комплексную оценку доступности и не заменяет экспертную проверку.

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

  • проверить контрастность цветовых пар в CSS
  • вычислить соответствие дизайна стандарту WCAG 2.2
  • найти недоступные сочетания текста и фона
  • сформировать список пар для улучшения дизайна

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

  • /token-contrast-auditor проанализируй контрастность в theme.css
  • проверь контрастность токенов в design-system.json

Как установить token-contrast-auditor

1Через Skills CLI (Vercel)

npx skills add ShuaiMXu/happyhands --skill token-contrast-auditor -a claude-code

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

~/.claude/skills/token-contrast-auditor/SKILL.md

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

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

Вопросы о token-contrast-auditor

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

Выполните команду npx skills add ShuaiMXu/happyhands --skill token-contrast-auditor -a claude-code в терминале вашего проекта.

Что делает token-contrast-auditor?

Скилл вычисляет коэффициент контрастности для заданных пар цветов и сравнивает его с нормами WCAG 2.2, выявляя потенциальные проблемы с доступностью интерфейса.

Что нужно для работы token-contrast-auditor?

Необходимы наличие дизайн-системы с цветовыми токенами, исходный код компонентов и файлов стилей.

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

SKILL.md · MIT
---
name: token-contrast-auditor
description: "Compute WCAG contrast for colour pairs the token names or the source state, and report which fail."
---

# Token Contrast Auditor

Whether a colour pair is legible is arithmetic, not taste. A team that darkens its danger colour is arguing about how it looks; the ratio against the surface it sits on is a number, and WCAG says what that number has to be.

## Required evidence

- a design foundation with colour tokens
- component and stylesheet sources, when pairs stated in code are also to be measured

## Which pairs are measured

Only pairs that something states:

- **Declared.** A role that has both a text token and a surface token — danger text on danger surface, success text on success surface. The names say these are used together.
- **Observed.** A declaration that sets a text colour and a background together, in a CSS rule or a style object. It states a pairing whatever the token names say.

A pair nobody expressed is not invented. Measuring every colour against every other produces a long list of failures that describe combinations the product never renders.

## Thresholds

WCAG 2.2 AA asks for 4.5:1 for normal text and 3:1 for large text and non-text contrast. A token pair does not carry the size or weight of the text it will hold, so the result reports which band a pair falls in rather than pretending to know:

- below 3:1 — fails every use
- 3:1 to 4.5:1 — carries large text or non-text only, and whether that is what it carries has to be checked in the interface
- 4.5:1 and above — passes AA

## Decisions

- Report the ratio, both values and where the pair came from, so the result can be checked by hand.
- Leave the fix open. Darkening the foreground, lightening the surface and restricting the pair to large text are all valid answers, and which one is right depends on the rest of the system.
- Skip a colour with an alpha channel and say so. What it renders as depends on what is behind it, and a ratio computed against the wrong backdrop is worse than no ratio.

## Boundary

Contrast is necessary, not sufficient. A pair that passes can still be illegible over a photograph, behind a gradient, or at a weight the ratio does not describe. Passing this audit is not an accessibility certification, and failing it is not always a defect — a disabled control is meant to recede.

Return structured evidence, findings, proposed updates and limitations. Use `needs-evidence` when required inputs or professional review are missing. Never invent an Experience Score or promote a project observation into a universal rule.

© ShuaiMXu · MIT · ShuaiMXu/happyhands

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

Все скиллы по теме «Фронтенд и UI» →
color-contrast-auditor curiositech Скилл color-contrast-auditor находит пары цветов, которые не проходят WCAG 2.1, и предлагает исправления. Пригодится перед релизом, при аудите CSS или когда текст на скриншоте не читается. CX Codex +1 262установок accessibility-auditor davila7 Скилл accessibility-auditor проверяет веб-интерфейсы на доступность и подсказывает исправления для WCAG, ARIA, клавиатурной навигации и скринридеров. CX Codex +1 846установок design-accessibility-auditor curiositech Скилл design-accessibility-auditor проверяет дизайны, палитры и компоненты на соответствие WCAG 2.1: контраст, размеры тач-таргетов, индикаторы фокуса и поддержку скринридеров. CX Codex +1 157установок image-to-code plugin87 Скилл image-to-code для Claude Code превращает скриншот, макет или референс в код интерфейса с общей темой дизайн-токенов. Запускается, когда нужно воссоздать UI по изображению. CX Codex +1 816установок brandkit plugin87 Скилл brandkit для Claude Code собирает дизайн-систему бренда из краткого описания: токены, светлую и тёмную темы, файл theme.css. Запускается по запросу создать основу бренда или набор токенов для продукта. CX Codex +1 594установок design-token-audit Owl-Listener Скилл design-token-audit проверяет, где в проекте обходят дизайн-токены: находит захардкоженные значения, дубли и пробелы в наборе токенов. CX Codex +1 2 700установок

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

Весь набор →
foundation-extractor Скилл foundation-extractor для Claude Code составляет полный список дизайнерских токенов и исходных кодов компонентов. Собирает данные из репозитория перед предложением новых правил дизайна. CX Codex +1 ★ 529звёзд репо component-inventory Скилл component-inventory для Claude Code собирает карту компонентов с путями к исходникам, вариантами и известными потребителями. Помогает оценивать повторное использование и искать расхождения. CX Codex +1 ★ 529звёзд репо visual-qa-evaluator Скилл visual-qa-evaluator для Claude Code готовит артефакты для оценки изменений интерфейса и поиска визуальных регрессий. Работает при сравнении скриншотов до и после правок. CX Codex +1 ★ 529звёзд репо brand-foundation-extractor Скилл brand-foundation-extractor для Claude Code собирает свидетельства о принципах бренда, голосе и визуальных материалах из проекта. Он отделяет явные декларации от текста интерфейса и сохраняет источники. CX Codex +1 ★ 529звёзд репо pattern-library-curator Скилл pattern-library-curator для Claude Code собирает принятые решения по интерфейсу в библиотеку паттернов проекта. Он включается при разборе повторяющихся решений и проверяет, хватает ли свидетельств для их повторного использования. CX Codex +1 ★ 529звёзд репо design-system-drift-detector Скилл design-system-drift-detector для Claude Code выявляет расхождения между кодом и дизайн-системой. Он находит неавторизованные значения, семантические конфликты и значения вне установленной сетки токенов. CX Codex +1 ★ 529звёзд репо fix-planner Скилл fix-planner для Claude Code превращает подтверждённую проблему в ограниченный план исправлений. Он учитывает данные проекта и утверждённые дизайн-решения. CX Codex +1 ★ 529звёзд репо component-state-auditor Скилл component-state-auditor для Claude Code сравнивает задокументированные состояния компонентов с правилами из файла rubric.json. Он помогает выявить недостающие состояния в коде и дизайне перед релизом. CX Codex +1 ★ 529звёзд репо

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

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