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

color-system · sanky369 — скилл для Claude Code: палитра и установка

Скилл color-system для Claude Code собирает цвета проекта в систему токенов и проверяет контраст текста с фоном. Настраивает палитру, исправляет контрастность и добавляет тёмную тему.

MIT 156 установок ★ 39 обновлён 2026-07-12

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

Что делает color-system

Сначала скилл ищет цвета в исходниках и конфигурации, изучает существующие токены и проверяет распространённые сочетания текста и фона. Затем собирает цветовые шкалы и семантические токены, а при необходимости — варианты для тёмной темы и статусов. Результат оформляется как файл токенов CSS или тема Tailwind с таблицей контрастности и картой замены старых цветов.

Для каждой пары с текстом скилл вычисляет контраст по WCAG: обычный текст должен пройти порог 4.5:1, крупный текст и элементы интерфейса — 3:1. Проверка нужна отдельно для светлого и тёмного режимов. Новую палитру он может подобрать сам, но если в коде уже есть явный фирменный цвет, скилл предлагает сохранить его и продолжить без дополнительных вопросов.

Скилл ориентирован на работу с цветовыми токенами и миграцию найденных значений: он предлагает перенести цвета из нескольких файлов, а остальные сопоставить с токенами. Для проектов без инфраструктуры токенов инструкция отсылает сначала к design-foundation; полный аудит доступности — отдельная задача для accessibility-excellence.

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

  • собрать цветовые шкалы из палитры проекта
  • заменить разрозненные цвета семантическими токенами
  • проверить контраст текста и фона по WCAG
  • добавить тёмную тему с отдельной проверкой контраста
  • развести цвета статусов и интерактивных элементов

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

  • Собери палитру проекта в цветовые шкалы и семантические токены, проверь контраст для светлой темы.
  • Добавь тёмную тему и пересчитай контраст всех сочетаний текста и фона.
  • Найди близкие оттенки, которые разошлись в коде, и составь карту замены на токены.

Как установить color-system

1Через Skills CLI (Vercel)

npx skills add sanky369/vibe-building-skills --skill color-system -a claude-code

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

~/.claude/skills/color-system/SKILL.md

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

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

Вопросы о color-system

Как установить color-system в Claude Code?

Выполните npx skills add sanky369/vibe-building-skills --skill color-system -a claude-code. Файл скилла устанавливается в ~/.claude/skills/color-system/SKILL.md.

Что делает color-system?

Он анализирует цвета проекта, оформляет их в шкалы и семантические токены, а затем считает контраст для текстовых и интерфейсных сочетаний. Также скилл может подготовить тёмную тему и карту миграции старых цветов.

Какие пороги контрастности проверяет скилл?

Для обычного текста он использует порог WCAG 4.5:1, для крупного текста и элементов интерфейса — 3:1. Светлый и тёмный режимы проверяются отдельно.

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

SKILL.md · MIT
---
name: color-system
description: "Build or repair a color system: full brand and neutral ramps, semantic color tokens, contrast-verified pairings, dark mode, and status colors — delivered as a tokens file (CSS variables / Tailwind theme) with every text pairing's contrast ratio computed. Use when the user says 'the colors look off', 'colors clash', 'add dark mode', 'is this accessible', 'pick a palette', 'too many blues in the codebase', 'make it match our brand', or when contrast failures are found. Extracts the de facto palette from the code first, consolidates drift into ramps, chooses harmony deliberately, and verifies WCAG AA on every shipped pair in both modes."
---

# Color System

Produce a contrast-verified color token file for this codebase — ramps, semantic layer, dark mode — with the math shown, not a color-theory lecture. Governing principle: **color is a system, not a list**: every hue ships as a full lightness ramp, components consume only semantic tokens, and no text/background pair ships without a computed contrast ratio.

## When to use / handoffs

- Use for palettes, ramps, dark mode, contrast fixes, status/interactive colors, theming.
- No token infrastructure exists → run `skills/frontend-design/design-foundation` first, or create the color slice as its start.
- "Everything is grey and flat / can't tell what's important" is usually hierarchy, not palette → `skills/frontend-design/visual-hierarchy-refactoring`.
- Full WCAG audit beyond color → `skills/frontend-design/accessibility-excellence`.

## Step 1 — Inspect the codebase

1. **Harvest the palette.** Grep for `#[0-9a-fA-F]{3,8}\b`, `rgba?\(`, `hsla?\(`, `oklch\(` across source + config. Deduplicate, count frequencies. Cluster near-identical values (ΔL < ~5) — each cluster is one intended color that drifted.
2. **Read existing tokens.** Tailwind `theme.colors` / `@theme` variables / CSS custom properties. Determine whether ramps exist or just single hexes.
3. **Identify the de facto brand color** — the most-used saturated hue.
4. **Check dark mode state**: `dark:` classes, `prefers-color-scheme`, a `.dark` block.
5. **Spot-check contrast** on the 3–5 most common text/background pairs found in code — compute the WCAG ratios; failures go straight into your rationale.

## Step 2 — Intake

Ask in one batch, only what's missing: **brand color to keep, or pick fresh** (and the personality if picking: trustworthy/energetic/premium/friendly), and **dark mode: now, later, or never**. Infer the rest. **Don't stall:** with a clear de facto brand color, keep it, state the assumption, proceed.

## Step 3 — Build the system

1. **Brand ramp.** Expand the brand color into an 11-step lightness ramp (50–950), holding hue roughly constant, adjusting chroma down at the extremes. Base usable for white text lands around step 600 for most hues.
2. **Neutral ramp — tinted, never true grey.** Desaturate the brand hue heavily (roughly 5–15% saturation) and build gray-50…950 from it. `#808080` and pure `#000` are banned; they read as foreign next to any brand color.
3. **Accent/secondary (only if the product needs one).** Choose by harmony rule: analogous (±30–60°) for cohesive/calm products; complementary (~180°) for a high-energy CTA accent used sparingly; triadic when the UI must color-code ≥3 categories. Don't add hues without a job.
4. **Status colors.** Success ≈ green, warning ≈ amber, error ≈ red, info ≈ cyan/blue — nudged toward the brand's temperature, each with at least a 100/600/700 mini-ramp (background tint, base, text-on-tint).
5. **Semantic layer.** `bg-primary/secondary/tertiary`, `text-primary/secondary/tertiary/disabled/inverse`, `border-primary/focus`, `interactive-primary/hover/active/disabled` — mapped from the ramps. Components never touch ramp values directly.
6. **Dark mode (if in scope).** Remap semantic tokens only: backgrounds to gray-900/950 (never `#000`), text to gray-50/300, brand shifted one step lighter (light mode's 600 → dark's 500) and slightly desaturated if it vibrates. Re-verify every pair — light-mode ratios don't transfer.
7. **Verify contrast on every shipped pairing.** Compute WCAG relative-luminance ratios: ≥4.5:1 normal text, ≥3:1 large text (≥24px, or ≥18.7px bold) and UI components/focus rings. That's the pass/fail gate. Where a pair passes WCAG but looks weak (light text on saturated mid-tone), treat APCA (Lc ≈ 60+ for body) as an advisory tiebreaker and darken a step.
8. **Color-blind safety.** Status colors must not be the only signal — pair with icon/label (red/green alone fails ~8% of male users). Avoid red-vs-green as the sole category distinction; blue/orange is the safest contrast pair.

### Canonical shape (CSS variables; adapt to detected stack)

```css
:root {
  --brand-600: #2563EB;  --brand-700: #1D4ED8;   /* full 50–950 ramp in the real file */
  --gray-600: #475569;   --gray-900: #0F172A;    /* brand-tinted neutrals, full ramp */
  --red-600: #DC2626;    --red-100: #FEE2E2;     /* status mini-ramps: green/amber/red/cyan */

  --color-bg-primary: #FFFFFF;
  --color-text-primary: var(--gray-900);      /* on bg-primary: 17.8:1 ✓ */
  --color-text-secondary: var(--gray-600);    /* on bg-primary: 7.6:1 ✓ */
  --color-interactive-primary: var(--brand-600); /* white on it: 5.2:1 ✓ */
}
.dark {
  --color-bg-primary: var(--gray-950);
  --color-text-primary: var(--gray-50);
  --color-interactive-primary: var(--brand-500);
}
```

Harmony theory, color psychology, ramp-construction technique, and color-blind palettes: `references/color-theory.md`.

## Step 4 — Wire in and migrate

Write tokens into the detected entry point (extend, don't fork). Migrate the top drift clusters from Step 1 in 1–3 high-traffic files; map the rest.

## Required output format

Deliver code plus this summary:

```
## Color tokens
[file path + full code]

## Palette decisions
- Brand: [hex] — [kept from code / chosen for [personality]]
- Neutrals: tinted toward [hue]
- Harmony: [mono/analogous/complementary/triadic] because [job it does]
- Dark mode: [shipped/deferred] — strategy: [.dark class / media query]

## Contrast verification
| Pair | Ratio | Standard | Pass |
| text-primary on bg-primary (light) | 17.8:1 | 4.5:1 | ✓ |
| white on interactive-primary | 5.2:1 | 4.5:1 | ✓ |
| text-secondary on bg-primary (dark) | ... | ... | ... |
[every shipped text and UI pairing, both modes]

## Migration map
| Found (cluster) | Count | Replace with |
| #3B82F6 / #3b82f7 / #3a80f0 | 23 | var(--color-interactive-primary) |
| ... |

## Migrated now
[files edited]
```

## Quality bar (check before delivering)

- [ ] Every text/background pair shipped has a computed ratio in the table; all ≥4.5:1 (normal) / ≥3:1 (large + UI), **both modes**
- [ ] Neutrals brand-tinted; no `#808080`, no pure `#000` backgrounds
- [ ] Every hue exists as a ramp, not a lone hex; each hue has a stated job
- [ ] Components/examples reference only semantic tokens
- [ ] Status meaning never carried by color alone (icon/label paired)
- [ ] Dark mode: backgrounds are dark grey, brand lightened a step, all pairs re-verified
- [ ] Focus indicator color ≥3:1 against adjacent colors
- [ ] Migration map covers every drift cluster found in Step 1

## Integration

- Consumes: token skeleton from `skills/frontend-design/design-foundation`; text sizes (for the large-text contrast threshold) from `skills/frontend-design/typography-system`.
- Produces: color tokens consumed by `skills/frontend-design/visual-hierarchy-refactoring` (lightness-based contrast hierarchy), `skills/frontend-design/component-architecture` (component color bindings), and audited by `skills/frontend-design/accessibility-excellence`.

## References

- `references/color-theory.md` — harmony techniques with examples, color psychology by hue, how to construct a ramp by hand, color-blind-safe palettes, and dark-mode pitfalls in depth. Read when picking a palette from scratch or debugging a ramp that looks wrong.

© sanky369 · MIT · sanky369/vibe-building-skills

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

Все скиллы по теме «Фронтенд и UI» →

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

color-system Owl-Listener Скилл color-system для Claude Code собирает палитру продукта: тональные шкалы, семантические роли и проверку контраста по WCAG. Помогает при создании или переделке цветовой системы с нуля. CX Codex +1 3 000установок bootstrap-color-system twbs Скилл bootstrap-color-system для Claude Code помогает менять цветовую систему Bootstrap 6 в Sass и CSS. Подключается при настройке цветов темы, цветовых режимов и семантических токенов. CX Codex +1 703установок color-motion iart-ai Скилл color-motion помогает подбирать палитры для моушн-дизайна, строить градиенты в пространстве OKLCH и устранять выцветание рендеров After Effects из-за сдвига гаммы. CX Codex +1 5 800установок color-palette jezweb Скилл color-palette строит полную цветовую систему из одного брендового hex: 11 оттенков, семантические токены, тёмная тема и проверка контраста по WCAG. CX Codex +1 3 400установок color-expert meodai Скилл color-expert для работы с колористикой, цветовым пространством OKLCH, шкалами дизайн-систем и палитрами для генеративной графики. CX Codex +1 3 100установок critique-color Owl-Listener Скилл critique-color разбирает цветовую схему одного экрана: измеряет контрастность текста и кнопок, проверяет палитру на лишние hex-значения и следит за доступностью интерфейса. CX Codex +1 2 100установок algorithmic-color-palette dembrandt Скилл algorithmic-color-palette выводит полную UI-палитру из одной-двух брендовых красок: состояния, серые с оттенком бренда, семантические цвета. CX Codex +1 1 100установок

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

Весь набор →
direct-response-copy Скилл direct-response-copy для Claude Code пишет рекламные тексты с одним целевым действием. Он включается для лендингов, объявлений, писем и страниц продаж. CX Codex +1 415установок tweet-writer Скилл tweet-writer для Claude Code генерирует твиты и треды с нуля, исследуя сначала, что работает в нише, потом предлагая несколько вариантов хуков и полный тред с альтернативами. CX Codex +1 325установок typography-system Скилл typography-system наводит порядок в типографике проекта: собирает модульную шкалу под плотность интерфейса, настраивает интерлиньяж и отдаёт готовые токены для Tailwind или CSS. CX Codex +1 265установок remotion-script-writer Скилл remotion-script-writer анализирует ваше приложение или идею и пишет сценарий Remotion в JSON: сцены с точными таймингами, элементы, анимации, текст и звук. Результат готов к рендеру. CX Codex +1 228установок product-video Скилл product-video продумывает сценарий продуктового видео, раскадровку с таймингами и готовые промпты ключевых кадров для генератора fal-ai/nano-banana-pro. CX Codex +1 218установок image-generation Скилл image-generation превращает расплывчатые запросы в детальные спецификации промптов и генерирует изображения через FAL.ai и модель nano-banana-pro. CX Codex +1 113установок brand-asset Скилл brand-asset пишет промпт-спеки для логотипов, иконок, паттернов и текстур в едином стиле и генерирует их через FAL.ai, когда задан FAL_API_KEY. CX Codex +1 111установок product-photography Скилл product-photography для Claude Code готовит промпты для фотосъёмки товаров и может сгенерировать изображения через FAL.ai. Включается для карточек товаров, лендингов и маркетинговых материалов. CX Codex +1 109установок

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

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