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

generic-design-system — скилл для Claude Code: обзор и установка

Скилл generic-design-system задаёт правила дизайн-системы для ИИ-агента: токены цветов, сетку отступов, типографику, анимации и состояния компонентов.

MIT 143 установок ★ 114 обновлён 2026-10-25

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

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

Скилл передаёт агенту единый свод правил оформления интерфейса под любой стек. Внутри зафиксирована трёхуровневая модель токенов — от примитивных значений вроде цвета до семантических переменных в коде. Справочник охватывает базовые единицы отступа 4px или 8px, шкалу шрифтов от 14px до 24px, контрастность по WCAG AA и размеры интерактивных зон от 44x44px.

Для анимаций скилл запрещает менять геометрию вроде width или margin: разрешены только GPU-свойства transform и opacity с длительностью от 100ms до 300ms. Если дизайн-системы в проекте ещё нет, автор рекомендует предварительно запустить скилл ui-research.

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

  • Сформировать семантические CSS-токены для цветов и темы
  • Настроить шкалу типографики и сетку отступов с шагом 4px или 8px
  • Проверить размеры кликабельных элементов на соответствие 44x44px
  • Добавить состояния кнопок и полей ввода без скачков вёрстки

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

  • Сформируй набор токенов для тёмной темы с учётом контраста 4.5:1 для основного текста
  • Сверстай компонент модального окна с ловушкой фокуса и закрытием по Escape
  • Добавь анимацию появления карточки через transform и opacity с длительностью 200ms

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

1Через Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill generic-design-system -a claude-code

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

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

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

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

Вопросы о generic-design-system

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

Выполните команду npx skills add travisjneuman/.claude --skill generic-design-system -a claude-code.

Что даёт этот скилл?

Он задаёт правила оформления интерфейса: семантические токены, шкалу шрифтов, правила анимации и контрастности по WCAG AA.

Для каких задач этот скилл не подходит?

Он не предназначен для проектирования UX-сценариев (для этого служит generic-ux-designer), архитектуры фич или общего ревью кода.

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

SKILL.md · MIT
---
name: generic-design-system
description: Complete design system reference for any project - colors, typography, spacing, components, animations. Adapts to project theme and tech stack. Use when implementing UI, choosing colors, creating animations, or ensuring brand consistency. For new design systems, use ui-research skill first.
---

# Generic Design System

Design system reference adapting to any project's visual language.

## Research First for New Systems

When creating a NEW design system (not following an existing one):

```
Skill(ui-research)  # Research modern patterns first
```

**References:**

- [UI Inspiration Sources](../_shared/UI_INSPIRATION_SOURCES.md) - Research sources
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - Visual tokens

## When to Use This Skill

**Use for:**

- Implementing UI components
- Choosing colors or typography
- Creating animations or transitions
- Ensuring visual consistency
- Setting up design tokens
- Reviewing design system compliance

**Don't use when:**

- UX flow design → use `generic-ux-designer`
- Feature architecture → use `generic-feature-developer`
- Code quality review → use `generic-code-reviewer`

## Design System Architecture

### When to Build vs Reference

| Situation              | Action                                  |
| ---------------------- | --------------------------------------- |
| Existing design system | Follow it strictly                      |
| No design system       | Use this skill to establish foundations |
| Partial system         | Identify gaps, extend consistently      |

### Token Organization

| Layer     | Example               | Purpose    |
| --------- | --------------------- | ---------- |
| Primitive | `--color-blue-500`    | Raw values |
| Semantic  | `--color-primary`     | Meaning    |
| Component | `--button-background` | Context    |

**Decision:** Use semantic tokens in code, primitive tokens as foundation only.

### Consistency Decision Tree

1. **Component exists?** → Use existing pattern
2. **Similar exists?** → Adapt existing (don't create competing pattern)
3. **New category?** → Propose to user, document reasoning

## Color System

**Every project should define:**

- Primary, Secondary, Accent
- Background, Foreground, Muted
- Destructive, Success, Warning

### Contrast Requirements

| Use Case      | Minimum    |
| ------------- | ---------- |
| Body text     | 4.5:1 (AA) |
| Large text    | 3:1 (AA)   |
| UI components | 3:1 (AA)   |

## Typography

### Font Stack

```css
--font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
--font-mono: "SF Mono", Monaco, "Courier New", monospace;
```

### Type Scale

| Name | Size | Use             |
| ---- | ---- | --------------- |
| sm   | 14px | Secondary text  |
| base | 16px | Body text       |
| lg   | 18px | Lead paragraphs |
| xl   | 20px | Section headers |
| 2xl  | 24px | Page headers    |

## Spacing System

**Base unit:** 4px or 8px

| Token | 4px Base | Use           |
| ----- | -------- | ------------- |
| 1     | 4px      | Tight spacing |
| 2     | 8px      | Default gap   |
| 4     | 16px     | Card padding  |
| 6     | 24px     | Page margins  |

## Animation

### GPU-Accelerated Only

**DO animate:** `transform`, `opacity`
**AVOID:** `width`, `height`, `top`, `left`, `margin`, `padding`

### Duration

| Token   | Duration | Use                |
| ------- | -------- | ------------------ |
| fast    | 100ms    | Micro-interactions |
| DEFAULT | 200ms    | Most transitions   |
| slow    | 300ms    | Complex animations |

### Timing

```css
--ease-default: cubic-bezier(0.4, 0, 0.2, 1);
--ease-bounce: cubic-bezier(0.68, -0.55, 0.265, 1.55);
```

## Components

### Component States

| State    | Visual Treatment  | Example                 |
| -------- | ----------------- | ----------------------- |
| Default  | Base styling      | Normal button           |
| Hover    | Subtle feedback   | Lighter/darker bg       |
| Active   | Pressed state     | Scaled down slightly    |
| Focus    | Visible outline   | 2px ring, offset        |
| Disabled | Reduced opacity   | 50% opacity, no pointer |
| Loading  | Spinner/skeleton  | Button with spinner     |
| Error    | Destructive color | Red border/text         |

### Touch Targets

- **Minimum:** 44x44px (WCAG 2.1 AAA)
- **Spacing:** 8px between adjacent targets
- **Mobile:** Consider 48x48px for primary actions

### Buttons

| Variant     | Use                 | Min Size |
| ----------- | ------------------- | -------- |
| Primary     | Main actions        | 44x44px  |
| Secondary   | Alternative actions | 44x44px  |
| Ghost       | Subtle actions      | 44x44px  |
| Destructive | Delete actions      | 44x44px  |

### Form Inputs

- Clear focus states (2px visible ring)
- Error states with messages
- Label always visible
- Required indicator

### Modals

- Focus trapped inside
- Escape to close
- Dark overlay (50-70% opacity)

## Responsive Breakpoints

| Token | Min Width |
| ----- | --------- |
| sm    | 640px     |
| md    | 768px     |
| lg    | 1024px    |
| xl    | 1280px    |

## Dark Mode

```css
:root {
  --background: #ffffff;
  --foreground: #000000;
}
[data-theme="dark"] {
  --background: #000000;
  --foreground: #ffffff;
}
```

## See Also

- [Design Patterns](./../_shared/DESIGN_PATTERNS.md) - Atomic Design, tokens, component docs
- [Code Review Standards](./../_shared/CODE_REVIEW_STANDARDS.md) - Accessibility checks
- `generic-ux-designer` - For UX flow and research decisions
- Project `CLAUDE.md` - Project-specific design constraints

**READ references when:**

- Setting up new design system → DESIGN_PATTERNS.md (full structure)
- Complex component patterns → DESIGN_PATTERNS.md (Atomic Design section)

© travisjneuman · MIT · travisjneuman/.claude

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

Все скиллы по теме «Дизайн» →
design-system affaan-m Скилл design-system собирает дизайн-систему из существующей вёрстки или проверяет её на визуальную консистентность: токены, оценка по десяти критериям, поиск шаблонных ИИ-приёмов. CX Codex +1 6 800установок design-system-architect Laith Aljunaidy Субагент design-system-architect собирает дизайн-систему целиком: токены, базовые документы и контракты компонентов. Подключается командами /ux-system и /ux-design --component, если системы в проекте ещё нет. CX Codex ★ 110звёзд репо design-system-starter davila7 Скилл design-system-starter помогает заложить дизайн-систему в проекте: генерирует дизайн-токены в JSON, структуру React-компонентов и проверяет контрастность по WCAG 2.1 AA. CX Codex +1 186установок tailwind-design-system sickn33 Скилл tailwind-design-system для Claude Code задаёт агенту рамки работы с Tailwind: токены, варианты компонентов, адаптивные паттерны и доступность. Помогает привести UI проекта к единому стилю. CX Codex +1 1 600установок ds-design-audit aicodeking Скилл ds-design-audit для Claude Code или Codex оценивает интерфейс экрана по визуальным критериям и коду, исправляет главные дефекты и проверяет результат перед релизом или при шаблонном виде страницы. CX Codex +1 548установок web-design pascalorg Скилл web-design даёт агенту справочник по веб-дизайну, разбитый на четыре уровня приоритета. Он используется перед работой над интерфейсом. CX Codex +1 192установок

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

Весь набор →
performance-engineering Скилл performance-engineering для Claude Code помогает оптимизировать производительность веб-приложений. Включается при падении показателей Core Web Vitals, росте бандла и замедлении работы страниц или API. CX Codex +1 144установок authentication-patterns Скилл authentication-patterns для Claude Code с паттернами аутентификации и авторизации. Подключается при работе над входом, MFA, SSO или моделью прав доступа. CX Codex +1 144установок i18n-localization Скилл i18n-localization для Claude Code помогает добавлять поддержку языков и локалей. Он подключается при работе с переводами, региональными форматами и подготовкой приложения для разных рынков. CX Codex +1 143установок vue-development Скилл vue-development для Claude Code помогает писать код на Vue 3 с синтаксисом Composition API и Script Setup. Подключается при настройке Pinia, создании композаблов и разработке на Nuxt 3. CX Codex +1 143установок event-driven-architecture Скилл event-driven-architecture для Claude Code помогает проектировать системы с асинхронными сообщениями, брокерами и распределёнными сценариями. Разбирает архитектуру микросервисов и потоков событий. CX Codex +1 143установок content-repurposer Скилл content-repurposer переделывает статью, отчёт или вебинар в тред, пост для LinkedIn, карусель и рассылку и подгоняет тон под площадку. CX Codex +1 142установок generic-feature-developer Скилл generic-feature-developer ведёт новую фичу по шагам: разобраться в коде, выбрать паттерн, собрать мелкими коммитами и проверить края перед закрытием. CX Codex +1 142установок generic-fullstack-design-system Скилл generic-fullstack-design-system для Claude Code помогает настраивать дизайн-систему во фулстек-проектах на Next.js и NestJS: тему, Tailwind, компоненты shadcn/ui и тёмную тему. CX Codex +1 142установок

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

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