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

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

Скилл design-system-documenter превращает сырые дизайн-токены в готовую документацию со справочными таблицами, правилами использования и контрастностью по WCAG.

MIT 165 установок ★ 274 обновлён 2026-10-30

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

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

Скилл принимает на вход готовый файл tokens.json или CSS-переменные и формирует документацию для разработчиков. Он раскладывает цвета, шрифты, отступы и тени по категориям. Для каждого токена создаются справочные таблицы со значениями, рекомендациями и правилами доступности.

Внутри документации генерируются примеры кода на CSS, правила Do/Don't и проверки контрастности текста. Дополнительно настраивается поведение для пользователей с prefers-reduced-motion. На выходе получаются файлы в Markdown для Docusaurus или VitePress, интерактивные страницы MDX или истории для Storybook.

Этот инструмент сам не создаёт дизайн-токены и компоненты. Если в проекте ещё нет файла стилей, скиллу просто не с чем будет работать.

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

  • оформить сырой tokens.json в читаемую базу знаний
  • проверить контрастность цветовых пар по стандарту WCAG
  • зафиксировать правила Do/Don't для защиты от ошибок в стилях
  • подготовить страницы токенов для Docusaurus, VitePress или Storybook

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

  • Сделай документацию в Markdown по нашим токенам из tokens.json с таблицами контрастности
  • Опиши палитру цветов из variables.css, добавь примеры использования и секцию Do/Don't
  • Подготовь спецификацию дизайн-токенов в формате MDX для компонентов кнопок и карточек

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

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill design-system-documenter -a claude-code

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

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

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

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

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

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

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

Что делает скилл design-system-documenter?

Он читает готовые дизайн-токены из JSON или CSS и преобразует их в документацию с таблицами значений, правилами применения и проверками доступности.

Умеет ли этот скилл генерировать сами токены с нуля?

Нет, он только документирует уже существующие токены. Для их создания автор рекомендует сначала запустить скилл design-system-generator.

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

SKILL.md · MIT
---
name: design-system-documenter
description: Creates comprehensive documentation for design systems - token tables, usage guidelines, component examples, and accessibility notes. Use after generating tokens to create developer-friendly
  docs.
allowed-tools: Read,Write,Glob
metadata:
  category: Documentation
  pairs-with:
  - skill: design-system-generator
    reason: Document tokens after generation
  - skill: docs-architect
    reason: Integrate into broader documentation
  tags:
  - design-system
  - documentation
  - tokens
  - styleguide
---

# Design System Documenter

Transform raw design tokens into developer-friendly documentation with usage examples, accessibility notes, and implementation guidelines.

## Quick Start

**Minimal example - document a token file:**

```markdown
Input: Generated tokens.json or CSS variables file
Output: Complete documentation with:
- Token reference tables
- Usage examples in code
- Accessibility annotations
- Do/Don't examples
```

**Key principle**: Documentation should answer "when do I use this?" not just "what is this?".

## Core Mission

Bridge the gap between generated tokens and developer adoption by creating documentation that:
1. Explains *when* to use each token (not just what it is)
2. Shows real code examples for common scenarios
3. Highlights accessibility considerations
4. Prevents misuse with anti-pattern examples

## When to Use

✅ Use when:
- Just generated design tokens and need docs
- Team struggles with "which token do I use?"
- Onboarding new developers to design system
- Creating a public design system site

❌ Do NOT use when:
- Need to generate tokens (use design-system-generator first)
- Need component code (use component-template-generator)
- Documenting non-design-system code (use docs-architect)

## Documentation Structure

### 1. Token Reference Tables

For each token category, generate tables with:

| Token | Value | Usage | Accessibility |
|-------|-------|-------|---------------|
| `--color-primary` | #FF5252 | CTAs, links, emphasis | ✅ 4.5:1 on white |
| `--color-border` | #000000 | All borders, dividers | — |

### 2. Usage Guidelines

```markdown
## Color Tokens

### Primary Colors
Use primary colors for:
- Call-to-action buttons
- Interactive links
- Important highlights

Do NOT use for:
- Body text
- Background fills (too saturated)
- Disabled states

### Code Example
```css
.button-primary {
  background: var(--color-primary);
  color: var(--color-text-on-primary);
  border: var(--border-width) solid var(--color-border);
}
```
```

### 3. Visual Examples

Include visual swatches and demonstrations:

```markdown
## Shadow Tokens

| Name | Preview | CSS Value |
|------|---------|-----------|
| shadow-sm | [2px offset visual] | `2px 2px 0 0 #000` |
| shadow-md | [4px offset visual] | `4px 4px 0 0 #000` |
| shadow-lg | [6px offset visual] | `6px 6px 0 0 #000` |

### Interaction States
- **Default**: `shadow-md`
- **Hover**: `shadow-lg` + translate(-2px, -2px)
- **Active**: `shadow-sm` + translate(2px, 2px)
```

### 4. Accessibility Section

```markdown
## Accessibility

### Color Contrast
| Combination | Ratio | WCAG Level |
|-------------|-------|------------|
| Primary on White | 4.8:1 | ✅ AA |
| Primary on Cream | 4.2:1 | ⚠️ AA Large only |
| Text on Primary | 8.2:1 | ✅ AAA |

### Motion
All animations respect `prefers-reduced-motion`:
```css
@media (prefers-reduced-motion: reduce) {
  * { animation-duration: 0.01ms !important; }
}
```
```

### 5. Do/Don't Examples

```markdown
## Common Mistakes

### ❌ Don't: Use shadow-lg on small elements
Small elements with large shadows look unbalanced.

### ✅ Do: Scale shadow with element size
- Small buttons: shadow-sm
- Cards: shadow-md
- Modals: shadow-lg

### ❌ Don't: Mix border styles
Inconsistent borders break visual rhythm.

### ✅ Do: Use consistent border tokens
Always use `--border-width` (3px) for neobrutalist consistency.
```

## Output Formats

### Markdown (Default)
Complete `.md` file for docs sites:
- Docusaurus/VitePress compatible
- Includes frontmatter for navigation
- Code blocks with syntax highlighting

### MDX (React docs)
Same as Markdown plus:
- Interactive color swatches
- Live code examples
- Token preview components

### Storybook
Documentation stories:
- Token showcase pages
- Interactive controls
- Design token addon integration

## Documentation Workflow

```
1. design-system-generator → tokens.json / tokens.css
2. design-system-documenter → tokens-docs.md
3. Review and customize
4. Publish to docs site
```

## Template: Token Documentation Page

```markdown
---
title: Design Tokens
description: Complete reference for [Project] design tokens
---

# Design Tokens

Generated from [trend-name] design trend.

## Quick Reference

| Category | Tokens | Description |
|----------|--------|-------------|
| Colors | 12 | Primary, neutral, semantic |
| Typography | 8 | Fonts, sizes, weights |
| Spacing | 15 | 0-24 scale |
| Shadows | 5 | Size and state variants |

## Colors

### Primary Palette
[Token table with hex, usage, accessibility]

### Neutral Palette
[Token table]

### Semantic Colors
[Token table for success, warning, error, info]

## Typography

### Font Families
[Token table with font stacks and usage]

### Font Sizes
[Scale table with px/rem values]

## Spacing

### Spacing Scale
[0-24 scale with rem values]

## Shadows

### Shadow Variants
[Visual examples with code]

## Usage Examples

### Button Component
[Complete code example using tokens]

### Card Component
[Complete code example using tokens]

## Accessibility

### Contrast Ratios
[All color combinations with WCAG levels]

### Motion Preferences
[Reduced motion handling]

## Migration Guide

### From Arbitrary Values
[Before/after examples]
```

## See Also

### References
- `references/documentation-templates.md` - Docusaurus, VitePress, Storybook, README templates
- `references/design-system-references.md` - **NEW**: Real-world design system references
  - Enterprise: Elastic UI, Red Hat PatternFly, Morningstar
  - Accessibility-first: Ariakit, Radix UI
  - Modern: HeroUI, shadcn/ui, Neobrutalism.dev
  - Framework-agnostic: Web Awesome, Shoelace
  - Award-winning sites from Awwwards for inspiration
  - Framer template categories (2900+ business, 1700+ creative)

### Related Skills
- design-system-generator - Generate tokens first (24 trends, 31 styles)
- component-template-generator - Create component code from tokens

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Дизайн» →
design-system rampstackco Скилл design-system для Claude Code и других платформ: собирает или проверяет дизайн-систему — токены, компоненты, именование, контрибуцию и документацию. Держит стиль продуктов согласованным. CX Codex +1 369установок design-systems Mindrally Скилл design-systems помогает агенту выстроить дизайн-токены, компонентную библиотеку и правила доступности в одном проекте. CX Codex +1 956установок extract-design-system arvindrk Скилл extract-design-system находит базовые токены дизайна на веб-странице и создаёт начальные файлы tokens.json и tokens.css. Он полезен для быстрого старта стилизации в новом репозитории. CX Codex +1 131 800установок ui-design-system Alireza Rezvani Скилл ui-design-system для Claude Code собирает дизайн-токены, палитры, типографику и структуру компонентов. Помогает создавать дизайн-системы и передавать макеты разработчикам. CX Codex +1 1 076установок design-system-generator OneWave-AI Скилл design-system-generator для Claude Code и других агентов: собирает дизайн-систему из токенов, базовых компонентов и документации. Выручает, когда цвета расползаются по второму экрану. CX Codex +1 324установок claude-design-system-architect OneWave-AI Скилл claude-design-system-architect для Claude Code собирает дизайн-систему по брифу или сайту и экспортирует токены, конфигурацию Tailwind и документацию. Формирует правила для нового продукта или разрозненного интерфейса. CX Codex +1 172установок

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

Весь набор →
values-behavioral-interview Скилл values-behavioral-interview для Claude Code помогает готовиться к интервью на соответствие ценностям и разбирать истории о неудачах. В репетициях задаёт подробные уточняющие вопросы. CX Codex +1 174установок interview-loop-strategist Скилл interview-loop-strategist выстраивает план подготовки к собеседованиям на позиции Senior ML/AI в Anthropic и другие компании. Он формирует график занятий, матрицу историй по проектам и координирует этапы. CX Codex +1 173установок interview-simulator Скилл interview-simulator проектирует платформу пробных собеседований с голосом, доской и адаптивной сложностью. Подходит для настройки тренировочных сессий и разбора прогресса. CX Codex +1 169установок code-architecture Скилл code-architecture с паттернами организации кода внутри одного приложения: чистая и гексагональная архитектура, структура по фичам, инверсия зависимостей и границы модулей. CX Codex +1 169установок win31-audio-design Скилл win31-audio-design для озвучки интерфейсов в духе Windows 3.1: 8-битные звуки, Web Audio API и тактильные отклики для веб- и мобильных приложений. CX Codex +1 165установок human-centered-design-fundamentals Скилл human-centered-design-fundamentals для Claude Code разбирает интерфейсы с точки зрения восприятия людьми действий и состояния системы. Помогает находить причины ошибок и оценивать понятность продукта. CX Codex +1 161установок llm-router Скилл llm-router выбирает модель и провайдера под конкретную задачу: сложность, бюджет, требования к качеству. Дешёвые задачи уходят на Haiku, сложные — на Sonnet или Opus. CX Codex +1 160установок systems-thinking Скилл systems-thinking для Claude Code разбирает сложные системы через запасы, потоки и петли обратной связи. Он подключается к задачам с повторяющимися проблемами и непредвиденными последствиями решений. CX Codex +1 160установок

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

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