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

design-system · oakoss — скилл для Claude Code: что делает и как установить

Скилл design-system для Claude Code собирает дизайн-систему с токенами, темами и архитектурой компонентов. Задаёт структуру для dark mode, CVA-вариантов и доступности.

MIT 160 установок ★ 29 обновлён 2026-08-17

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

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

Скилл раскладывает дизайн-систему по слоям: primitive, semantic и component tokens. Он подсказывает, как строить dark mode через data-theme, настраивать multi-brand темизацию, оформлять варианты компонентов через cva() и VariantProps, а также собирать compound components с общим контекстом.

В материалах есть рекомендации для Radix primitives, Tailwind v4, Style Dictionary и Storybook. Отдельные разделы посвящены фокусу, prefers-reduced-motion, WCAG, SSR-защите от вспышки темы и governance с версионированием токенов и компонентов. Жёстко заданные hex- и px-значения в файлах компонентов здесь считаются ошибкой: визуальные значения должны приходить из semantic или component tokens.

Скилл также задаёт направления для делегирования: аудит хардкода отдаётся Explore, миграция библиотеки и проверка доступности — Task, планирование multi-brand архитектуры — Plan. Для работы нужны файлы проекта и соответствующие инструменты из описанных сценариев, например Storybook или Style Dictionary, если вы их используете.

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

  • разложить токены по уровням primitive, semantic и component
  • настроить dark mode и multi-brand темы через CSS custom properties
  • описать варианты компонентов с cva() и VariantProps
  • проверить фокус, контраст и reduced motion
  • связать компоненты со Storybook и процессом версионирования

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

  • Разложи текущие цвета и размеры по слоям primitive, semantic и component tokens.
  • Спроектируй dark mode и multi-brand темизацию через data-theme и CSS custom properties.
  • Проверь компоненты на фокус, контраст WCAG и поддержку prefers-reduced-motion.

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

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill design-system -a claude-code

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

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

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

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

Вопросы о design-system

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

Выполните npx skills add oakoss/agent-skills --skill design-system -a claude-code, затем проверьте файл ~/.claude/skills/design-system/SKILL.md.

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

Скилл помогает проектировать токены, темы и API компонентов, включая cva()-варианты, Radix primitives, Storybook и правила доступности.

Какой порядок токенов использует скилл?

Токены идут в одном направлении: primitive → semantic → component. Компоненты должны ссылаться на semantic tokens, чтобы темы можно было менять без жёстких значений в коде.

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

SKILL.md · MIT
---
name: design-system
description: 'Builds scalable design systems with tokens, theming, and component architecture. Use when creating design token hierarchies, theming systems, component variant patterns, or accessibility foundations. Use for design tokens, CVA variants, dark mode, multi-brand theming, Radix headless UI, Storybook documentation, and governance.'
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://designtokens.org'
user-invocable: false
---

# Design System

## Overview

Single source of truth for visual consistency at scale — a shared language between design and engineering. Covers token architecture, theming infrastructure, component API patterns, accessibility compliance, and governance workflows.

Design systems are not component libraries alone. They unify tokens, patterns, documentation, and contribution processes so teams build once and maintain once.

## Quick Reference

| Area                | Pattern                                 | Key Points                                                           |
| ------------------- | --------------------------------------- | -------------------------------------------------------------------- |
| Token hierarchy     | Primitive > Semantic > Component        | Never reference primitives in components; semantic layer is themable |
| Dark mode           | Swap semantic tokens via `data-theme`   | Use off-white/dark-gray, not pure white/black                        |
| Multi-brand theming | Override semantic tokens per brand      | Apply via CSS custom properties at runtime                           |
| Tailwind v4         | `@theme` block in CSS (no config file)  | CSS-first configuration replaces `tailwind.config.js`                |
| CVA variants        | `cva()` for variant + size combinations | Type-safe with `VariantProps`; pair with `cn()` utility              |
| Compound components | `Modal.Header`, `Modal.Body` sub-parts  | Composition over configuration; shared context for implicit state    |
| Headless UI         | Radix primitives + Tailwind classes     | Accessibility built-in; bring your own styles                        |
| Focus management    | `focus-visible:ring-2` on all controls  | 2px solid outline with offset; visible on keyboard only              |
| Reduced motion      | `prefers-reduced-motion` media query    | Near-zero duration for all transitions and animations                |
| Style Dictionary    | JSON tokens to CSS/iOS/Android          | `outputReferences: true` preserves token chain                       |
| Storybook           | Stories + autodocs + a11y addon         | Visual documentation with accessibility audit built in               |
| Governance          | Semver for tokens and components        | Breaking = removed props/tokens; minor = new additions               |

## Common Mistakes

| Mistake                                       | Correct Pattern                                                          |
| --------------------------------------------- | ------------------------------------------------------------------------ |
| Primitive tokens in components (`blue-500`)   | Reference semantic tokens (`interactive-primary`) that map to primitives |
| Skipping focus states on interactive elements | Add `focus-visible:ring-2` on every button, link, and input              |
| Body text set to `gray-400`                   | Use `gray-600` or darker to meet 4.5:1 WCAG AA contrast                  |
| Circular token references between layers      | Tokens flow one direction: primitive > semantic > component              |
| Ignoring `prefers-reduced-motion`             | Wrap all animations in a reduced-motion media query                      |
| Using `scale()` transforms for hover          | Use `translateY(-1px)` and shadow changes to avoid layout shift          |
| Hardcoded hex/px values in component files    | All visual values come from semantic or component tokens                 |
| Deep CSS nesting for theme overrides          | Override CSS custom properties at the semantic layer                     |
| Theme flash on page load (FOUC)               | Inject synchronous theme script in `<head>` before body renders          |
| Flat token list without layers                | Organize into primitive, semantic, and component tiers                   |

## Delegation

- **Audit codebase for hardcoded values that should be tokens**: Use `Explore` agent
- **Migrate a component library to a token-based design system**: Use `Task` agent
- **Plan a multi-brand theming architecture**: Use `Plan` agent
- **Review accessibility compliance across components**: Use `Task` agent

> If the `motion` skill is available, delegate animation token integration and motion design patterns to it.

## References

- [Design Tokens](references/design-tokens.md) — three-layer hierarchy, CSS custom properties, TypeScript definitions, naming conventions
- [Theming](references/theming.md) — dark mode, theme provider, multi-brand, Tailwind v4, SSR flash prevention
- [Color and Typography](references/color-and-typography.md) — 60-30-10 rule, contrast requirements, type scale, fluid typography
- [Component Architecture](references/component-architecture.md) — CVA variants, compound components, headless UI, polymorphic rendering
- [Accessibility](references/accessibility.md) — WCAG compliance, keyboard navigation, ARIA patterns, screen reader testing
- [Motion and Layout](references/motion-and-layout.md) — animation tokens, reduced motion, spacing grid, elevation system
- [Tooling](references/tooling.md) — Style Dictionary, Storybook, component testing, visual regression
- [Governance](references/governance.md) — versioning, deprecation, contribution workflow, component lifecycle
- [Troubleshooting](references/troubleshooting.md) — common issues, dark mode fixes, token sprawl, pre-delivery checklist

© oakoss · MIT · oakoss/agent-skills

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

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

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

design-system claudekit Скилл design-system для Claude Code собирает дизайн-токены, спецификации компонентов и презентационные слайды. Объединяет интерфейс и слайды общей дизайн-системой. CX Codex +1 54 500установок design-system affaan-m Скилл design-system собирает дизайн-систему из существующей вёрстки или проверяет её на визуальную консистентность: токены, оценка по десяти критериям, поиск шаблонных ИИ-приёмов. CX Codex +1 6 800установок design-system официальный anthropics Проверяет дизайн-систему на несоответствия, документирует компоненты и проектирует новые паттерны. Запускается одной командой /design-system audit, document или extend. CX Codex +1 4 700установок design-system Donchitos Скилл design-system для Claude Code и других агентных сред. Ведёт по секциям GDD одной игровой системы, проверяет связи с зависимостями и удерживает документ от расползания. CX Codex +1 731установок design-system daveebbelaar Скилл design-system для Claude Code собирает дизайн-систему macOS-приложения из цветовых и интерфейсных токенов. Он подключается при настройке акцентного цвета, тем или общих правил для экранов. CX Codex +1 1 000установок design-system-patterns Seth Hobson Скилл design-system-patterns для Claude Code, Codex и Cursor с паттернами архитектуры дизайн-систем: токены, темизация, компонентные библиотеки. Включается при создании токенов, переключении тем и закладке фундамента UI. CX Codex +1 15 953установок design-system-documenter curiositech Скилл design-system-documenter превращает сырые дизайн-токены в готовую документацию со справочными таблицами, правилами использования и контрастностью по WCAG. CX Codex +1 165установок design-system-engineer josstei Субагент design-system-engineer проектирует иерархию дизайн-токенов, строит контракты API для компонентов и настраивает переключение тем без прямого указания цветов и отступов в коде. CX Codex ★ 489звёзд репо design-systems Mindrally Скилл design-systems помогает агенту выстроить дизайн-токены, компонентную библиотеку и правила доступности в одном проекте. CX Codex +1 956установок Design System taste f Промпт Design System taste для ChatGPT задаёт стандарты проектирования дизайн-систем, токенов, доступности и компонентов в коде. GP ChatGPT ★ 178 201звёзд репо design-system-creation secondsky Скилл design-system-creation для Claude Code собирает дизайн-систему: токены, типографику, компоненты и документацию. Фиксирует стандарты интерфейса до начала вёрстки. CX Codex +1 512установок

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

Весь набор →
tanstack-query Помогает агенту писать запросы и мутации на TanStack Query v5, переводить код с v4 и настраивать инвалидацию кэша. CX Codex +1 170установок threejs Помогает создавать 3D-сцены на Three.js, подключать WebGPU и React Three Fiber. Помогает настраивать шейдеры, загружать модели и повышать производительность. CX Codex +1 167установок accessibility Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров. CX Codex +1 164установок react-performance Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок zustand Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context. CX Codex +1 158установок tanstack-start По TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой. CX Codex +1 156установок pglite Скилл по PGlite: подсказывает агенту, как поднять сборку PostgreSQL 17.4 на WASM в браузере или Node.js, выбрать хранилище и настроить live-запросы. CX Codex +1 156установок tanstack-table Настраивает headless-таблицы TanStack Table v8 в React: серверная пагинация, фильтры и сортировка без циклических ререндеров. CX Codex +1 155установок

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

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