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

craft-states — скилл для Claude Code: состояния экранов

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

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

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

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

Скилл помогает составить список состояний интерфейса до отрисовки макета. Для каждого пункта нужно отметить, что отображается, почему состояние не подходит или какой вопрос остаётся открытым; список сначала показывают на согласование. Затем скилл ведёт через создание главного состояния и остальных применимых состояний, их проверку и упорядочивание досок.

Внутри есть каталог состояний и инструкции по адаптерам Paper, Figma и HTML. Если подходящего адаптера для инструмента нет, те же действия выполняются вручную; без инструмента для дизайна используется HTML. Значения, снятые с изображения, считаются оценочными. Перед началом читают DESIGN.md, если он есть, дизайн-систему и существующие экраны проекта.

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

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

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

  • Спроектируй экран заказов и сначала составь список всех его состояний.
  • Проверь, какие состояния пропущены в этом макете перед передачей в разработку.
  • Переработай этот экран: учти длинные имена, ошибки загрузки и действия другого пользователя.

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

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

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

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

2Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о craft-states

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

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

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

Помогает перечислить состояния интерфейса до отрисовки, создать макеты применимых состояний и проверить их по списку. Также задаёт порядок и названия досок.

Когда craft-states не запускается?

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

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

SKILL.md · MIT
---
name: craft-states
description: Use when designing or redesigning a screen, flow or component, when asked to cover all states or find missing ones, or before handing a screen to code. Also use when a design only shows the happy path, uses short tidy sample data, or assumes a single user.
---

# Screen states

## Overview

A screen is not designed until every state it can be in is designed. The happy path is one state out of twenty. **List the states in words first, get the list approved, then draw.** Agreeing on a list costs a minute. Discovering a missing state in code costs a day.

## When to use

- A new screen, flow or component, or a redesign of one.
- "Cover all the states", "what are we missing?", "is this ready for dev?"
- The design shows one perfect case: three orders, short names, everything loaded.

## When NOT to use

- A small edit to an existing screen ("make the button 2px taller", "fix this typo"). Make the edit and stop.
- Pure copy changes, or a question about the design.

## Before you start

0. Read `DESIGN.md` at the project root if it exists: it is the project's design brief.
1. Read the project's design system and existing screens. They win on look: reuse their empty state, banner and loading pieces instead of inventing new ones.
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. Know the screen's job: who uses it, what they came to do, and what the one next action is.

## Steps

1. **Write the state list.** Walk every group in [the state catalogue](references/state-catalog.md): Data, System, Activity, People, Interaction. Mark each item in one of three ways:
   - **applies**, with a one-line description of what the screen shows;
   - **doesn't apply**, with a reason;
   - **open question** for the person.

   **Stop and show the person the list.** Do not draw yet.
2. **Draw the main state** with realistic invented data: the most complex realistic case, not the tidiest. Use long names, many items, and mixed statuses. Build it one section at a time, and check each section rendered before the next.
3. **Draw every other state that applies:**
   - a state that changes the whole screen (empty, offline, couldn't load) gets a full board;
   - a state that changes one part (a failed row, a saving button, a stale banner) goes on a state sheet that shows just that part.
4. **Check every state:**
   - Does it offer the action that resolves it, and say who does it?
   - Does moving between states keep the layout still (same widths and heights, no jumping)?
5. **Name and order the boards** as described in [naming and sheets](references/naming-and-sheets.md): `<number> · <screen> · <state>`, the main state first, the other states next, sheets last, and a cover note at the start of each row.
6. **Look at what you made.** Screenshot or render every board and compare it with the list. If you cannot render, say so plainly, and name what wasn't checked.

## Rules

| Rule | Why |
|---|---|
| The list comes before any drawing, and the person approves it | It's the cheapest moment to find a missing state or one that doesn't apply |
| Sample data is long, many and messy | Short tidy data hides truncation, overflow and wrapping bugs |
| Assume more than one person uses it | "Someone else already did it" and "changed while you looked" happen every day |
| No state without a way out: what to do next and who does it | A dead end makes people call support |
| A failure is worded as a failure, never as a deliberate pause | "Stopped" reads like someone chose it; "Couldn't save" tells the truth |
| One standard empty-state piece across the product | Ten bespoke empty states drift apart and cost ten times more |
| A whole-app problem goes in a top banner; a problem with one item goes inline on that item | A banner for one row's error shouts at everyone about nothing |
| Loading and label swaps keep the element's size | Layout shift makes people click the wrong thing |
| Interaction states (hover, focus, disabled…) come from the design system's states matrix | Redrawing them on every screen creates drift; draw them once, in the system |

## Done when

Every catalogue item is drawn, marked "doesn't apply" with a reason, or listed as an open question. The boards are named and ordered, and you looked at each one or said which you couldn't.

## Common mistakes

| Thought | Reality |
|---|---|
| "I'll just design all the states in one go, it's faster" | Without an approved list you draw states nobody needs and miss the ones they do. List, stop, then draw. |
| "Three sample orders show the idea" | Show forty, and show a customer called "Maria Fernanda de Albuquerque Santos". The overflow state is a real state. |
| "Loading, empty, error, offline: covered" | Those are four of the catalogue's groups' easiest items. Also check many/overflow, long text, someone-else-did-it, changed-while-viewing, permissions and slow. |
| "I'll put all the states on one page" | An unnamed pile can't be reviewed or handed off. Name and order the boards. |
| "I couldn't render it, but it's fine" | Say what you couldn't check. Unverified layout is a guess. |

## Red flags: stop and go back to step 1

- You are drawing and no state list was approved.
- Every name in the mock fits on one line.
- The design never mentions a second person.

© Diego Fernandes · MIT · diego3g/craft

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

Каталог скиллов SKILL.md →
loading-states Owl-Listener Скилл loading-states для Claude Code помогает проектировать экраны ожидания, когда контент загружается не сразу. Он выбирает паттерн загрузки по ситуации: от скелетона до оптимистичного обновления. CX Codex +1 2 700установок beam-glow-states MengTo Скилл beam-glow-states для Claude Code помогает добавить React-интерфейсам светящийся контур для загрузки, выбора, фокуса и других состояний. Агент подключает его при работе с карточками, кнопками, полями и панелями. CX Codex +1 1 700установок loading-states-and-perceived-performance dembrandt Скилл loading-states-and-perceived-performance для ИИ-кодинга, который помогает выбрать спиннер, скелетон или прогресс-бар и сделать интерфейс быстрее на ощупь. CX Codex +1 1 000установок button-states dembrandt Скилл button-states для Claude Code описывает шесть состояний интерактивных элементов и вычисляет цвета hover и active из базового цвета по сдвигу светлоты в HSL. CX Codex +1 1 000установок rc-subscription-states RevenueCat Скилл rc-subscription-states помогает проверять доступ к платным функциям Android через RevenueCat и обновлять интерфейс по состоянию подписки. CX Codex +1 756установок United States Weather smithery-ai MCP-сервер United States Weather отдаёт агенту текущую погоду по США, прогноз до 7 дней, почасовой на 48 часов и предупреждения. Ключ API не нужен. CX Codex +1 17 177установок

Из того же набора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-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-system Скилл craft-system для Claude Code помогает создавать и менять дизайн-систему, а также проверять её на расхождения. Он включается при работе с токенами, компонентами и экранами. CX Codex +1 ★ 393звёзд репо craft-sync Скилл craft-sync для Claude Code переносит токены и компоненты между кодом и дизайн-инструментом. Включается перед дизайн-задачей или по просьбе импортировать систему и синхронизировать правки. CX Codex +1 ★ 393звёзд репо craft Плагин craft для Claude Code помогает проектировать экраны с полным набором состояний и проверять дизайн перед показом. Задайте задачу на создание или изменение интерфейса: плагин выберет подходящий скилл. ★ 393звёзд репо

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

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