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

craft-system — скилл для Claude Code: дизайн-система

Скилл craft-system для Claude Code помогает создавать и менять дизайн-систему, а также проверять её на расхождения. Он включается при работе с токенами, компонентами и экранами.

MIT ★ 393 обновлён 2026-11-15

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add diego3g/craft
/plugin install craft@craft
Открыть на GitHub

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

Скилл помогает создавать дизайн-систему по слоям: сначала задаются цветовые роли, типографика, отступы и правила взаимодействия, затем по одному добавляются компоненты. Для компонентов он описывает варианты и состояния, а новые элементы заносит в индекс. Между этапами создание останавливается для согласования.

При изменении общего компонента скилл перечисляет экраны и участки кода, которых коснётся правка, и ждёт одобрения перед распространением изменений. Для аудита он составляет отчёт с уровнями серьёзности, местом проблемы и предлагаемым исправлением. Аудит не меняет файлы до выбора правок. Перед началом он читает DESIGN.md, если этот файл есть, и использует подходящий адаптер из references/adapters/; без инструмента дизайна предусмотрен вариант с HTML.

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

  • создать дизайн-систему с токенами и правилами взаимодействия
  • добавить компонент и перечислить затронутые экраны
  • найти расхождения между гайдом, экранами и кодом

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

  • Создай дизайн-систему для этого проекта и покажи основы перед компонентами.
  • Добавь вариант кнопки и перечисли экраны и участки кода, которые затронет изменение.
  • Проведи аудит дизайн-системы и выдай отчёт, не меняя файлы.

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

1Через маркетплейс плагинов

/plugin marketplace add diego3g/craft
/plugin install craft@craft

Команда ставит плагин craft целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add diego3g/craft --skill craft-system -a claude-code

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

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

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

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

Вопросы о craft-system

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

Добавь маркетплейс командой /plugin marketplace add diego3g/craft, затем установи скилл командой /plugin install craft@craft.

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

Скилл помогает создавать дизайн-системы, менять компоненты и токены, а также искать расхождения в гайде, экранах и коде. Перед распространением изменений он показывает затронутые места и ждёт одобрения.

Меняет ли craft-system файлы при аудите?

Нет. Он выдаёт отчёт с проблемами и предлагаемыми исправлениями, а файлы меняет только после выбора правок.

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

SKILL.md · MIT
---
name: craft-system
description: Use when starting a design system, style guide or token set, adding or changing a component or token, standardizing screens that drifted apart, or auditing a guide for loose colours, one-off pieces, missing states or screens that don't match it.
---

# Design system

## Overview

A design system is the place where a decision is made once and then reused everywhere. Every colour is a token, every interactive piece shows all its states, and every change reaches every screen that uses the piece. **Build it in layers, foundations first, and stop for approval at each layer. An audit reports and never fixes on its own.**

## When to use

- "Start a style guide / design system / tokens for …"
- Adding a component, variant or token, or changing an existing one.
- "Make these screens consistent", "standardize", "audit the guide", or loose hex values and one-off pieces in the screens.

## When NOT to use

- A question about one value ("what's our primary colour?"): answer it.
- A small edit the person described exactly (one value, one label, one size), even on a shared piece: change it once where it's defined and say which screens it affects. No states matrix, no stop.

## Before you start

0. Read `DESIGN.md` at the project root if it exists: it is the project's design brief.
1. Find what exists: tokens, the guide, the components, the screens and the code. **An existing guide wins on look.** Follow its rules even where they differ from the defaults below, and mention the difference once.
2. Pick your tool's adapter in `references/adapters/` (`paper.md`, `figma.md`, `html.md`). If no adapter matches your tool, do the same verbs in your tool and say which you mapped by hand. With no design tool at all, build in HTML (`html.md`). If an image is all you have, say that values read from it are estimates.
3. Decide the mode: **create**, **add or change**, or **audit**.

## Steps · create

1. **Foundations draft:**
   - colour roles ([token roles](references/token-roles.md));
   - type scale;
   - spacing;
   - radius;
   - shadows (two at most);
   - layout widths;
   - motion durations;
   - a short "how we write" section.

   Name tokens by role (`text-muted`, `border-hover`, `danger-bg`), never only by value (`gray-500`).
2. **Interaction rules, once:** for bordered pieces, borderless pieces and the primary action, write how hover, pressed, focus (keyboard only), disabled, loading and selected look. Components follow these rules instead of each inventing its own.
3. **Stop and show the person the foundations and the interaction rules.** Don't build components yet.
4. **Components one at a time, in the order the first screens need them.** Each gets a guide section with the [component anatomy](references/component-anatomy.md): a legend with the rule and why, examples, and a **states matrix** of variants × states. Add each one to the **component index**.

## Steps · add or change a piece

1. Check whether an existing component plus a variant covers it. Prefer reuse to a one-off.
2. Draw it with the anatomy, including the full states matrix. A new colour, size or icon becomes a token or an icon-set entry now, not later.
3. **List every screen and code location that uses the piece.**
4. **Stop and show the person the change and that list.**
5. On approval, propagate:
   - update every screen on the list;
   - update the code, if any. When `DESIGN.md` says the design system's source is code, do it with **REQUIRED SUB-SKILL:** `craft-sync` (export), so the code change is a reviewed diff. If that diff holds only the change just approved and no conflicts, the approval carries over: say so and apply, without a second stop;
   - update the component index;
   - report what changed where.

## Steps · audit

1. Run the [audit checklist](references/audit-checklist.md) over the guide, the screens and the code if any.
2. Write the report: findings ranked by severity, each with where it is, why it matters and the proposed fix.
3. **Stop and show the person the report. Change no file until they say which fixes to make.** Saving copies of the originals doesn't make editing them acceptable.

## Rules

**Firm (any project):**

| Rule | Why |
|---|---|
| Every colour is a token; no loose hex values in screens or code | Loose values drift into near-duplicates that nobody can change at once |
| One icon set | Mixed sets look like mixed products |
| Design and code change together, design first | Otherwise the guide stops being the truth within a week. When the system's source is code, "design first" means: draw the change in the tool, then land it in code through an approved export |
| Every interactive piece has a states matrix | States drawn ad hoc on screens never agree |
| A change to a shared piece is listed with the screens it affects before it propagates | Otherwise one "small" change silently redesigns twenty screens |

**Defaults (an existing guide overrides them):**

| Default | Why |
|---|---|
| On hover, bordered pieces only darken the border | A changing background on cards and fields feels heavy |
| Hover is subtler than selected | When hover looks like selected, people think two things are chosen |
| Selecting never changes font weight | A weight change shifts the text's width |
| Placeholders are lighter than muted text | Otherwise a placeholder reads as entered text |
| Items in stacked lists and menus have a small gap, never touching | Touching highlights merge into one block |
| The focus ring only appears from the keyboard | A ring after a mouse click looks like a bug |
| Loading keeps the element's exact size | Layout shift |
| Shadows only on floating things (menus, popovers, dialogs, toasts), at two strengths | Shadows everywhere flatten the hierarchy they were meant to create |
| At most one primary action per screen | Two primaries means the screen didn't decide |

## Done when

- **Create:** foundations and interaction rules approved; each component has its anatomy, states matrix and an index row.
- **Change:** every listed screen and code location updated, and the index updated.
- **Audit:** a ranked report delivered and no file changed.

## Common mistakes

| Thought | Reality |
|---|---|
| "I'll build the whole guide in one go: tokens and ten components" | Ten components on unapproved foundations means ten reworks. Foundations, stop, then components. |
| "The audit found problems, I'll just fix them" | The person may disagree with half of the fixes. Report, stop, fix only what they pick. |
| "I kept the originals in a backup folder, so fixing is safe" | A backup doesn't make the person agree with the fixes. Report first. |
| "Buttons have hover and disabled, good enough" | A states matrix has every state × every variant: normal, hover, pressed, focus, disabled, loading, selected. |
| "`--teal-600` is a token" | It's a value. Components need roles (`--color-primary`) so the value can change in one place. |
| "This screen needs a slightly different card" | Make it a variant of the card, or use the card. A one-off is the start of drift. |

© Diego Fernandes · MIT · diego3g/craft

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

Все скиллы по теме «Дизайн» →
design-system-lead borghei Скилл design-system-lead помогает проектировать трёхуровневые дизайн-токены, структуру компонентов и правила поставки интерфейсной библиотеки. CX Codex +1 262установок design-system-creator curiositech Скилл design-system-creator для Claude Code собирает дизайн-системы: токены, CSS-архитектуру, библиотеку компонентов и документацию. Создаёт систему для нового UI и аудита существующих стилей. CX Codex +1 250установок design-system-creation aj-geddes Скилл design-system-creation для Claude Code собирает дизайн-систему: компоненты, токены, правила и документацию. Держит структуру, когда растут интерфейсы или команды. CX Codex +1 545установок component-family-consistency dembrandt Скилл component-family-consistency для Claude Code помогает согласовать стили кнопок, полей, бейджей и других компонентов. Подключается при работе с UI-компонентами, библиотекой компонентов и дизайн-системой. CX Codex +1 1 000установок extract aladicf Скилл extract находит повторяющийся интерфейсный код, выносит его в дизайн-систему, формирует токены и переводит проект на единые компоненты. CX Codex +1 595установок design-system-starter davila7 Скилл design-system-starter помогает заложить дизайн-систему в проекте: генерирует дизайн-токены в JSON, структуру React-компонентов и проверяет контрастность по WCAG 2.1 AA. CX Codex +1 186установок

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

using-craft Скилл using-craft для Claude Code направляет задачи по дизайну интерфейса к нужному скиллу из набора Craft. Для новой страницы он сначала проверяет, есть ли в корне проекта DESIGN.md. CX Codex +1 ★ 393звёзд репо craft-explore Скилл craft-explore для Claude Code предлагает варианты дизайна экрана, потока или отдельного элемента. Запускается, когда нужны альтернативы или текущий вариант не нравится. CX Codex +1 ★ 393звёзд репо craft-states Скилл craft-states для Claude Code помогает спроектировать состояния экрана, потока или компонента. Включается при редизайне и проверке макета перед передачей в разработку. CX Codex +1 ★ 393звёзд репо craft-critique Скилл craft-critique для Claude Code проверяет дизайн экрана и предлагает точечные правки. Запускается на просьбу оценить или улучшить макет, перед показом готового экрана и передачей дизайна в код. CX Codex +1 ★ 393звёзд репо craft-setup Скилл craft-setup для Claude Code, который собирает вводные о продукте и записывает их в DESIGN.md. Запускается перед первой экранной задачей, если в корне проекта ещё нет этого файла. CX Codex +1 ★ 393звёзд репо craft Скилл craft для Claude Code проектирует и перерабатывает страницы, экраны, потоки и элементы интерфейса. Перед созданием проверяет контекст проекта, перечисляет состояния и сверяет результат. CX Codex +1 ★ 393звёзд репо craft-sync Скилл craft-sync для Claude Code переносит токены и компоненты между кодом и дизайн-инструментом. Включается перед дизайн-задачей или по просьбе импортировать систему и синхронизировать правки. CX Codex +1 ★ 393звёзд репо craft Плагин craft для Claude Code помогает проектировать экраны с полным набором состояний и проверять дизайн перед показом. Задайте задачу на создание или изменение интерфейса: плагин выберет подходящий скилл. ★ 393звёзд репо

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

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