design-system-creator — скилл для Claude Code: функции и установка
Скилл design-system-creator для Claude Code собирает дизайн-системы: токены, CSS-архитектуру, библиотеку компонентов и документацию. Создаёт систему для нового UI и аудита существующих стилей.
MIT 250 установок ★ 274 обновлён 2026-10-30
npx skills add curiositech/some_claude_skills --skill design-system-creator -a claude-codeЧто делает design-system-creator
design-system-creator помогает создать дизайн-систему с токенами цветов, отступов и типографики, CSS custom properties, правилами именования и описанием компонентов. Он также оформляет дизайн-библию со структурой основ, компонентов, паттернов и руководств.
Внутри есть рабочий процесс от аудита текущих стилей до проверки доступности и адаптивности. Скилл использует инструменты чтения и редактирования файлов, а также интеграции 21st.dev, stability-ai и firecrawl. Для цветовых токенов он требует формат OKLCH; фактическая реализация компонентов относится к другим скиллам.
Какие задачи решает
- создать токены цветов, отступов и типографики
- разложить CSS по слоям ITCSS
- описать библиотеку компонентов и их состояния
- аудировать существующие стили для выделения дизайн-системы
- подготовить дизайн-библию с примерами
Примеры запросов агенту
- Создай дизайн-систему для этого проекта с токенами, компонентами и правилами CSS.
- Проведи аудит текущих стилей и выдели из них дизайн-токены.
- Подготовь дизайн-библию: опиши состояния компонентов, доступность и адаптивное поведение.
Как установить design-system-creator
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill design-system-creator -a claude-code2Вручную: положить файлы
~/.claude/skills/design-system-creator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/design-system-creator/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill design-system-creator -a codex2Вручную: положить файлы
.agents/skills/design-system-creator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill design-system-creator -a cursor2Вручную: положить файлы
.cursor/skills/design-system-creator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/design-system-creator2Вручную: положить файлы
.github/skills/design-system-creator/SKILL.md1Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill design-system-creator -a gemini-cli2Командой платформы
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/design-system-creatorВручную: положить файлы
.devin/skills/design-system-creator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill design-system-creator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о design-system-creator
Как установить design-system-creator в Claude Code?
Выполните npx skills add curiositech/some_claude_skills --skill design-system-creator -a claude-code. Файл скилла появится по пути ~/.claude/skills/design-system-creator/SKILL.md.
Что делает design-system-creator?
Скилл создаёт токены, CSS-архитектуру, документацию компонентов и дизайн-библию. Он также помогает проверить существующие стили и подготовить темы.
Какие цвета использует design-system-creator?
Для цветовых токенов скилл использует OKLCH, а не hex или HSL. Фактическую реализацию UI-компонентов он не заменяет.
Исходный текст
SKILL.md · MIT
---
name: design-system-creator
description: Builds comprehensive design systems and design bibles with production-ready CSS. Expert in design tokens, component libraries, CSS architecture. Use for design system creation, token architecture,
component documentation, style guide generation. Activate on "design system", "design tokens", "CSS architecture", "component library", "style guide", "design bible". NOT for typography deep-dives (use
typography-expert), color theory mathematics (use color-theory-palette-harmony-expert), brand identity strategy (use web-design-expert), or actual UI implementation (use web-design-expert or native-app-designer).
allowed-tools: Read,Write,Edit,Glob,mcp__magic__21st_magic_component_builder,mcp__magic__21st_magic_component_refiner,mcp__stability-ai__stability-ai-generate-image,mcp__firecrawl__firecrawl_search
metadata:
category: Design & Creative
pairs-with:
- skill: typography-expert
reason: Typography decisions for the system
- skill: color-theory-palette-harmony-expert
reason: Color token architecture
tags:
- design-system
- tokens
- components
- css
- style-guide
---
# Design System Creator
Design systems architect and CSS expert specializing in creating comprehensive, scalable design bibles.
## When to Use This Skill
✅ **Use for:**
- Creating design tokens from scratch (colors, spacing, typography scales)
- Building CSS custom property architectures
- Documenting component libraries with usage guidelines
- Creating design bibles and style guides
- Establishing naming conventions (BEM, OOCSS, SMACSS)
- Auditing existing CSS for design system extraction
- Theming and dark mode token systems
- Multi-brand/white-label token structures
❌ **Do NOT use for:**
- Typography selection and pairing → **typography-expert**
- Color theory and palette generation → **color-theory-palette-harmony-expert**
- Brand identity and visual direction → **web-design-expert**
- Actual component implementation → **web-design-expert** or **native-app-designer**
- Icon design → **web-design-expert**
- Motion design principles → **native-app-designer**
## Three-Tier Token Architecture
The foundation of scalable design systems:
```css
:root {
/* 1. PRIMITIVE - Raw values (ALWAYS use OKLCH for colors) */
--color-blue-500: oklch(62.8% 0.195 252.5);
--space-4: 1rem;
/* 2. SEMANTIC - Purpose-driven */
--color-primary: var(--color-blue-500);
--space-component-padding: var(--space-4);
/* 3. COMPONENT - Specific usage */
--button-bg: var(--color-primary);
--button-padding: var(--space-component-padding);
}
```
→ See `references/token-architecture.md` for dark mode, multi-brand, and complete examples.
## OKLCH: The Modern Color Standard
**⚠️ CRITICAL: Always use OKLCH for color tokens, not hex or HSL.**
OKLCH is perceptually uniform - equal L values mean equal perceived lightness. This is essential for:
- Generating harmonious color scales
- Ensuring accessibility (L=50% is true middle gray)
- Theming (adjust L for dark mode, C for brand intensity)
```css
:root {
/* OKLCH format: oklch(Lightness% Chroma Hue) */
/* Primary scale - same hue, varying lightness */
--color-primary-100: oklch(95% 0.05 252);
--color-primary-500: oklch(62% 0.19 252);
--color-primary-900: oklch(30% 0.15 252);
/* Dark mode: reduce L uniformly */
--color-bg-light: oklch(98% 0.01 252);
--color-bg-dark: oklch(15% 0.02 252);
}
```
**Essential OKLCH Resources:**
| Resource | Purpose |
|----------|---------|
| [oklch.com](https://oklch.com/) | Interactive OKLCH color picker |
| [Evil Martians: Why Quit RGB/HSL](https://evilmartians.com/chronicles/oklch-in-css-why-quit-rgb-hsl) | Why OKLCH is the new standard |
| [Harmonizer](https://harmonizer.evilmartians.com/) | Generate harmonious palettes in OKLCH |
**OKLCH Benefits for Design Systems:**
- **Perceptual uniformity**: L=70% always looks 70% light
- **Better contrast**: APCA-ready lightness calculations
- **Easier scaling**: Math operations work predictably
- **Native CSS**: `oklch()` works in all modern browsers (2023+)
## Design Bible Structure
### 1. Foundation
- Brand Identity, Design Principles
- Color System, Typography Scale
- Spacing Scale, Grid System
### 2. Components
For each component document:
- Purpose, Anatomy, Variants
- States (default, hover, active, disabled, focus)
- Responsive behavior
- Accessibility (ARIA, keyboard, screen readers)
- Code examples
### 3. Patterns
- Page Layouts, Navigation
- Forms, Data Display
- Feedback (alerts, toasts, modals)
### 4. Guidelines
- Writing (voice, tone)
- Imagery, Motion, Accessibility
→ See `references/component-documentation.md` for templates.
## CSS Organization (ITCSS)
```
styles/
├── 0-settings/ # Tokens, custom properties
├── 1-tools/ # Mixins, functions
├── 2-generic/ # Reset, normalize
├── 3-elements/ # Typography, forms (unclassed)
├── 4-objects/ # Layout patterns
├── 5-components/ # UI components
├── 6-utilities/ # Helpers, overrides
└── main.css # Import all
```
→ See `references/css-organization.md` for BEM naming and full structure.
## Anti-Patterns to Avoid
### 1. Token Explosion
**What it looks like**: 500+ tokens with overlapping purposes
**Why it's wrong**: Defeats constraints; developers can't choose
**Fix**: Limit to 6-8 spacing tokens. If you need more, fix the scale.
### 2. Missing Semantic Layer
**What it looks like**: Components reference primitives directly
**Why it's wrong**: Can't theme, can't change brand without touching every component
**Fix**: Three-tier tokens: Primitive → Semantic → Component
### 3. Documentation Drift
**What it looks like**: Design bible says one thing, CSS does another
**Why it's wrong**: Developers stop trusting documentation
**Fix**: Generate docs from CSS comments, or use Storybook
### 4. Utility Class Overload
**What it looks like**: `class="p-4 m-2 bg-blue-500 text-white..."`
**Why it's wrong**: HTML unreadable, design intent lost
**Fix**: Use utilities sparingly; most styles in semantic component classes
### 5. Breaking the Scale
**What it looks like**: `padding: 13px;` (why 13?)
**Why it's wrong**: Every exception erodes the system
**Fix**: If the scale doesn't work, fix the scale
### 6. No Version Control
**What it looks like**: "Which button is correct?"
**Why it's wrong**: Multiple sources of truth
**Fix**: Single source of truth with version numbers, deprecation warnings
## Working Process
1. **Audit**: Review existing patterns and inconsistencies
2. **Define**: Establish tokens and foundational system
3. **Build**: Create component library with documentation
4. **Document**: Write comprehensive design bible
5. **Test**: Validate accessibility and responsiveness
6. **Deliver**: Package with examples and starter templates
## MCP Integrations
| MCP | Purpose |
|-----|---------|
| **21st.dev** | Scaffold components quickly with modern patterns |
| **Storybook** | Extract existing component structure (when available) |
| **Figma** | Sync design tokens from Figma variables (when available) |
| **Stability AI** | Generate placeholder images for documentation |
| **Firecrawl** | Research design system best practices |
## Output Deliverables
- **Design Bible Document**: Complete markdown/HTML with visual examples
- **CSS Codebase**: Well-commented, modular, production-ready
- **Component Library**: Interactive examples with all variants
- **Quick Start Guide**: Getting started, customization, common recipes
## References
→ `references/token-architecture.md` - Three-tier tokens, dark mode, multi-brand
→ `references/css-organization.md` - ITCSS, BEM, component file structure
→ `references/component-documentation.md` - Doc templates, quick reference cards
## Integrates With
- **typography-expert** - Typography scale and font selection
- **color-theory-palette-harmony-expert** - Color palette generation
- **web-design-expert** - Brand identity and visual direction
- **adhd-design-expert** - ADHD-friendly design tokens
---
*Remember: A design system is a living product that serves products.*
© curiositech · MIT · curiositech/some_claude_skills