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

design-md · shuaimxu — скилл для Claude Code: создание документации дизайна

Скилл design-md для Claude Code создаёт в проекте файл DESIGN.md, описывающий правила визуального языка. Инструмент анализирует текущий код и оформляет контракт для ИИ-агентов.

MIT ★ 529 обновлён 2026-11-17

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

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

Скилл классифицирует состояние репозитория, чтобы выбрать подходящий сценарий работы: фиксация существующего стиля, объединение с имеющейся документацией или предложение концепции для новых проектов. При выборе последнего варианта агент составляет план и дожидается подтверждения от пользователя.

Результатом работы становится корневой файл DESIGN.md с описанием токенов, шрифтов, компонентов и анимаций, а также вспомогательный скилл frontend-design. Инструмент строго следует принципам: описывает реальное состояние кодовой базы, ссылается на конкретные файлы и никогда не меняет существующие компоненты без прямой команды.

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

  • создать описание дизайна на основе кода
  • синхронизировать документацию стилей с реализацией
  • упорядочить правила UI для работы ИИ-агентов
  • подготовить проект к масштабированию дизайна

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

  • /plugin:design-md add a DESIGN.md
  • /plugin:design-md document our design language
  • /plugin:design-md bootstrap design

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

1Через Skills CLI (Vercel)

npx skills add ShuaiMXu/happyhands --skill design-md -a claude-code

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

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

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

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

Вопросы о design-md

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

Выполните команду npx skills add ShuaiMXu/happyhands --skill design-md -a claude-code. После этого файл скилла будет доступен по пути ~/.claude/skills/design-md/SKILL.md.

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

Этот скилл создаёт живой контракт DESIGN.md, который помогает ИИ и разработчикам понимать правила построения интерфейса, основываясь на фактических файлах проекта.

Что нужно для работы design-md?

Для работы не требуется дополнительных ключей API, однако проект должен содержать исходный код UI, чтобы агент мог провести аудит текущих стилей.

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

SKILL.md · MIT
---
name: design-md
description: Create or update a repo's DESIGN.md — a living design-language contract for AI agents and humans — plus a portable frontend-design skill. Classifies the repo first (document an existing design language, merge with existing design docs, or propose a new direction with user approval) so it never overwrites a project's current design. Use when setting up design docs for a frontend project. Triggers on "add a DESIGN.md", "document our design language", "set up design docs", "create a design system doc", "bootstrap design".
license: MIT
metadata:
  version: "1.0.0"
---

# Design Language Doc (DESIGN.md)

You are creating this repository's design-language contract: a root `DESIGN.md` that tells agents and humans exactly how UI is built here, plus a portable `frontend-design` craft skill. The doc is **downstream of the code** — you describe the design language that exists, or propose one with user approval. You never invent a design language and present it as fact, and you never restyle existing UI to match a doc.

## Goal

1. Root `DESIGN.md` — the repo's design language, written from evidence, citing real files and tokens
2. `.agents/skills/frontend-design/SKILL.md` — portable craft doctrine (typography, surfaces, motion) that applies to any repo
3. A link from `AGENTS.md` so agents find the design language within one hop

## Reference templates

| File | Used for |
|------|----------|
| `references/design-md-template.md` | `DESIGN.md` skeleton, filled from evidence |
| `references/skill-frontend-design.md` | `.agents/skills/frontend-design/SKILL.md` (create verbatim) |

## Phase 0: Audit, then classify (before writing anything)

Gather evidence. Every claim in `DESIGN.md` must trace back to something you saw here:

- [ ] `package.json`: framework, UI libraries (react/vue/svelte, tailwind, shadcn, radix/base-ui, motion/framer-motion, lucide, fonts packages)
- [ ] Token layer: `globals.css` / `tailwind.config.*` / theme files — CSS variables, `@theme` blocks, custom utilities (shadows, radii, animations)
- [ ] Fonts: how they're loaded (`next/font`, `@font-face`, link tags), which families, which roles
- [ ] Component system: `components/ui/`, shared primitives, variant patterns (cva, variants props)
- [ ] Motion: keyframes, transition utilities, motion-library usage, `prefers-reduced-motion` handling
- [ ] The 3–5 most polished surfaces in the app — these define the *actual* design language, whatever the tokens claim
- [ ] Existing design docs: `DESIGN.md`, `docs/design*`, brand guidelines, Figma links in READMEs, design-related Cursor rules or agent docs

Then classify the repo into exactly one mode:

### Mode A — Document (established design language, no design doc)

The repo has consistent tokens, deliberate font choices, a component system, recurring motifs. Your job is **extraction**: write `DESIGN.md` describing what exists, citing the files that prove it. Nothing about the actual design changes. Where the codebase is internally inconsistent, document the dominant/most-recent pattern and note the deviation — do not resolve it by fiat.

### Mode B — Merge (design docs already exist)

A `DESIGN.md`, brand guide, or design-related rules already exist. **Merge, never regenerate**: preserve every unique local rule, deduplicate against the template structure, keep one source of truth, and leave pointers behind if you consolidate scattered docs. If existing docs contradict the code, flag the contradiction to the user instead of silently picking a side.

### Mode C — Propose (greenfield, no coherent design language)

No established language exists. Choosing an aesthetic direction is a **user-owned decision**, not an evidence question. Write a one-page proposal to `docs/plans/design-language.md` (or `PLAN.md` if the repo has no `docs/plans/`) covering: aesthetic direction and tone, font pairing (display + body), color approach and the accent budget, elevation strategy, motion approach. Offer 2–3 distinct directions if the product context supports them. **Stop and get user approval before writing `DESIGN.md`.** After approval, write the full doc from the approved proposal.

## Deliverables

```
DESIGN.md                              # root design-language contract (living document)
.agents/
  skills/
    frontend-design/SKILL.md           # portable craft doctrine (references/skill-frontend-design.md)
docs/
  plans/
    design-language.md                 # Mode C only: the approved proposal
```

Plus one edit: add `- [Design Language](DESIGN.md)` to the Quick Links in `AGENTS.md` (create the section if the repo has an `AGENTS.md` without it; skip if there is no `AGENTS.md`).

## Process (in order)

1. **Phase 0** audit and classification (checklist above)
2. Mode C only: write the proposal, present it, and **wait for approval**
3. Write `DESIGN.md` using `references/design-md-template.md` as structure — filled from evidence (Modes A/B) or the approved proposal (Mode C)
4. Create `.agents/skills/frontend-design/SKILL.md` verbatim from `references/skill-frontend-design.md` (stripping the template preamble), unless the repo already has an equivalent craft skill — then skip it
5. Link `DESIGN.md` from `AGENTS.md` Quick Links
6. Run the **verification pass** below
7. Report: mode chosen and why, files created, contradictions found between docs and code, rules preserved from pre-existing docs

## Writing rules for DESIGN.md

- **Cite real files.** Every token, utility, font, and component pattern named in the doc must link to the file that defines it
- **Name the budgets.** Great design languages are mostly restraint — make limits explicit ("one accent pairing per view", "at most one display-font moment per page"), because agents follow budgets better than vibes
- **Include the one-liner.** A blockquote near the top that compresses the whole language into one paragraph an agent can carry to another surface
- **End with a per-page checklist** of verifiable items, phrased so an agent can self-review against them
- **Sizes over adjectives.** "`rounded-3xl` cards, `rounded-full` CTAs" beats "generously rounded"
- Semantic tokens over hardcoded values everywhere the repo's token system reaches; name the sanctioned exceptions explicitly

## Constraints

- **Never restyle existing components to match `DESIGN.md`.** The doc describes or proposes; it does not authorize a refactor. If the user wants the UI brought in line with the doc, that is a separate, explicit task
- In Modes A and B, do not "improve" the design language while documenting it — record improvement ideas at the end under a clearly-marked "Open questions" section instead
- Do not copy another product's design language (fonts, palettes, motifs) into `DESIGN.md` unless verified in THIS repo or approved in the Mode C proposal
- Prefer an accurate short doc over an impressive long one — an agent that trusts a wrong design doc produces confidently wrong UI
- Match the repo's markdown tone and formatting

## Verification pass (required before finishing)

- [ ] Every file path referenced in `DESIGN.md` resolves to an existing file
- [ ] Every token, utility class, and font named in the doc exists in the codebase (grep for it)
- [ ] Modes A/B: no rule in the doc contradicts what the most polished surfaces actually do
- [ ] Mode B: every unique rule from the pre-existing docs survived the merge (diff them)
- [ ] Mode C: the doc matches the approved proposal; the proposal file exists in `docs/plans/`
- [ ] The `AGENTS.md` link resolves
- [ ] The checklist at the end of `DESIGN.md` contains only items an agent can verify from code

## Done when

- An agent building UI in this repo can answer "what fonts, what tokens, what radii, what shadows, what motion?" from `DESIGN.md` alone, one hop from `AGENTS.md`
- The user's existing design decisions are intact — nothing was overwritten, and any new direction was explicitly approved
- The portable `frontend-design` craft skill is installed
- Every doc statement is evidence-backed (or approval-backed) and the verification pass is clean

© ShuaiMXu · MIT · ShuaiMXu/happyhands

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

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

design-md официальный google-labs-code Скилл выгружает экраны из Google Stitch через MCP-сервер и собирает файл DESIGN.md с описанием дизайн-системы, цветов и компонентов. CX Codex +1 67 200установок design-md nexu-io Скилл design-md для Claude Code создаёт и редактирует файлы DESIGN.md с направлением дизайна, токенами и визуальными правилами. Агент подключает его по запросам о дизайн-документе или дизайн-токенах. CX Codex +1 3 300установок design-md Hermes Agent Скилл помогает создавать и проверять спецификации DESIGN.md с токенами дизайна, а затем экспортировать их в форматы Tailwind и W3C DTCG. CX Codex +1 541установок design-system-adoption Owl-Listener Скилл design-system-adoption для Claude Code помогает составить стратегию внедрения дизайн-системы и подготовить материалы для команд. Включайте его, когда система уже есть, но команды её игнорируют. CX Codex +1 2 400установок design-flow julianoczkowski Скилл design-flow ведёт от уточняющих вопросов до готовых компонентов: шесть фаз подряд, каждая с подтверждением перед следующей. CX Codex +1 5 500установок design-brief julianoczkowski Скилл design-brief проводит интервью о задаче, смотрит существующий код и сохраняет дизайн-бриф в markdown. Пригодится перед стартом новой страницы или фичи. CX Codex +1 5 500установок design-handoff официальный anthropics Скилл design-handoff превращает макет или его описание в спецификацию для разработчиков: размеры, токены, состояния, брейкпоинты, краевые случаи. CX Codex +1 4 000установок frontend-design mager Скилл frontend-design для Claude Code задаёт визуальный язык проекта: определяет настроение, типографику, палитру и ритм отступов при создании или обновлении интерфейса. CX Codex +1 1 700установок awesome-design-md wearescientist Скилл awesome-design-md подбирает стиль интерфейса из библиотеки DESIGN.md и применяет его к вёрстке: layout, цвет, типографика, отступы. CX Codex +1 1 100установок

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

Весь набор →
component-state-auditor Скилл component-state-auditor для Claude Code сравнивает задокументированные состояния компонентов с правилами из файла rubric.json. Он помогает выявить недостающие состояния в коде и дизайне перед релизом. CX Codex +1 ★ 529звёзд репо visual-hierarchy-reviewer Скилл visual-hierarchy-reviewer для Claude Code проверяет иерархию задач и визуальный язык интерфейса по скриншотам. Он включается при разборе дизайна или просьбе убрать ощущение «сгенерированного ИИ», сохранив стиль продукта. CX Codex +1 ★ 529звёзд репо review-video Скилл review-video для Claude Code проверяет и чинит продуктовые или промо-видео по исходному проекту, таймкодам изменений и независимой ревизии таймлайна. Запускается при видеопроизводстве или разборе багов монтажа. CX Codex +1 ★ 529звёзд репо happyhands Скилл happyhands для Claude Code разбирает конкретную проблему интерфейса или опыта продукта и помогает исправить её. Для явно запрошенного продуктового или рекламного видео он запускает отдельный процесс разбора. CX Codex +1 ★ 529звёзд репо frontend-design Скилл frontend-design для Claude Code задаёт стандарты оформления интерфейсов и типографики. Запускается при проектировании или проверке компонентов веб-интерфейсов. CX Codex +1 ★ 529звёзд репо review-product Скилл review-product для Claude Code помогает найти и проверить улучшение пользовательского сценария в готовом приложении. Он разбирает задачу, предлагает ограниченное изменение и сравнивает результат до и после. CX Codex +1 ★ 529звёзд репо happyhands-ui Скилл happyhands-ui для Claude Code задаёт правила текста, цвета, типографики и взаимодействий. Он включается при создании или проверке интерфейсов HappyHands либо проекта, который принял этот профиль. CX Codex +1 ★ 529звёзд репо experience-remediation Скилл experience-remediation для Claude Code исправляет UI и UX интерфейсов. Он запускается для устранения дефектов вёрстки и проблем взаимодействия по правилам проекта. CX Codex +1 ★ 529звёзд репо

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

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