craft · diego3g — Claude Code skill: what it does, how to install
The craft Claude Code skill designs and revises pages, screens, flows, and UI elements. It checks project context, maps states, and reviews each board before presenting it.
MIT ★ 393 updated 2026-11-15
/plugin marketplace add diego3g/craft
/plugin install craft@craftWhat craft does
craft creates interface designs from the project brief and design system. It starts with DESIGN.md, tokens, and related screens. If the file is missing or has no Product section, it calls craft-setup first.
For multiple items, the skill asks to confirm the scope before drawing. craft-states lists each item's states; craft-explore joins when the design direction is open. New components and tokens go through craft-system, and craft-critique checks every board after drawing. A matching adapter for the design tool is needed; with no design tool, craft builds in HTML. Decisions go into the DESIGN.md log.
When the brief conflicts with the code, craft follows the code's tokens and records the conflict in DESIGN.md rather than overriding them in page CSS. Values read from an image are estimates.
What it helps with
- design a page from a project brief and its tokens
- map states across several screens
- resolve a mismatch between the brief and code
- review a board and log design decisions
Example prompts for the agent
- Design a pricing page using the project brief and existing components.
- Create welcome, sign-up, and verification screens for onboarding.
- Redesign the profile screen and check its states.
How to install craft
1Plugin marketplace
/plugin marketplace add diego3g/craft/plugin install craft@craftThis installs the whole craft plugin with all its skills
2Skills CLI (Vercel)
npx skills add diego3g/craft --skill craft -a claude-code3Manually: put the files in place
~/.claude/skills/craft/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/craft/
1Skills CLI (Vercel)
npx skills add diego3g/craft --skill craft -a codex2Manually: put the files in place
.agents/skills/craft/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add diego3g/craft --skill craft -a cursor2Manually: put the files in place
.cursor/skills/craft/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install diego3g/craft skills/craft2Manually: put the files in place
.github/skills/craft/SKILL.md1Skills CLI (Vercel)
npx skills add diego3g/craft --skill craft -a gemini-cli2Platform CLI
gemini skills install https://github.com/diego3g/craft --path skills/craftManually: put the files in place
.devin/skills/craft/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about craft
How do I install craft in Claude Code?
Run /plugin marketplace add diego3g/craft, then /plugin install craft@craft. Another option is npx skills add diego3g/craft --skill craft -a claude-code.
What does craft do?
It designs or revises interfaces using the project brief and design system, maps screen states, and runs a self-review on each board. Decisions are saved in DESIGN.md.
What happens when the brief and code use different design tokens?
craft follows the code, records the mismatch in DESIGN.md, and offers to update the side that is out of date. It does not override tokens in page CSS.
Source text
SKILL.md · MIT
---
name: craft
description: Use when asked to design, create, mock up or redesign one or more pages, screens, flows or UI elements, or when the person runs /craft (/craft:craft in the Claude Code plugin).
---
# Craft
## Overview
The front door for making anything visual. It turns "design the pricing page" into a finished, reviewed design. It works from the project's brief, covers every state, offers options only when the direction is open, uses only the design system's pieces, and checks its own work before showing it. **It calls the other design skills at fixed points; it doesn't replace them.**
## When to use
- "Design / create / mock up / redesign the <page, screen, flow, element>", `/craft` (`/craft:craft` in the Claude Code plugin).
- Several pages at once ("design the onboarding: welcome, sign-up, verify").
## When NOT to use
- A small edit the person described exactly (one value, one label, one size): make it.
- Only a review ("what's wrong with this?"): `craft-critique`. Only options: `craft-explore`.
## Before you start
- If no adapter in `references/adapters/` 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.
## Stops are real
A **stop** means: end your turn with the question and wait. You can always do that, even in a one-shot or headless session, where your final message *is* the question. **Never decide a stop for the person because the session "can't wait" or "to save a round trip".** Deciding it yourself turns a five-second answer into hours of redoing.
## Steps
1. **Context.**
- Read `DESIGN.md` at the project root. **If it's missing, or has no Product section** (a sync-only record) → **REQUIRED SUB-SKILL: `craft-setup`**, then come back here.
- Read the design system (tokens, components, guide) and the screens related to this one.
- **When the brief and the code disagree** (the brief says teal, the tokens say blue): follow the **code**, say so in one line, add the conflict to `DESIGN.md` › Open questions, and offer to update whichever is wrong. Never override tokens inside a page's own CSS.
- **When the design tool's guide and the code differ** and a `design-sync.json` exists, don't call the guide stale. Classify with it: **code changed** → offer to refresh the guide before drawing; **guide changed** → it's the person's change waiting for an export, so draw with it and mention the pending export.
2. **Scope in words.** List each page or element to make, each with its job and its one next action.
- Ambiguous words get one interpretation stated plainly ("pricing page = the bakery's price list, not subscription plans").
- **Stop and confirm the list** when there's more than one item or the request is vague. One clear item: go on.
3. **For each item, in order:**
1. **REQUIRED SUB-SKILL: `craft-states`.** Its written state list and its stop come first.
2. **Open direction?** Only when the person asked for ideas, or when two structurally different layouts are plausible and neither the brief nor the system chooses between them → **REQUIRED SUB-SKILL: `craft-explore`** before drawing the states. For several pages, ask at the scope stop which page (if any) gets options; never run an option round per page by default. The states are then drawn in the picked direction. A screen that follows an existing pattern goes straight to drawing.
3. **Draw** the main state, then the other states, **using only the system's pieces and tokens**. Something new (a component, a colour, a size the scale doesn't have) → **REQUIRED SUB-SKILL: `craft-system`** (add mode) before using it. A component that **exists in code but isn't drawn in the tool** ("in code only" in the index) → **REQUIRED SUB-SKILL: `craft-sync`** (import of one component), drawing just that component first. If the person declined the import (see `DESIGN.md`), ask once before importing; if they still say no, build from the code's values on the board itself and note it. Never draw a look-alike, and never hard-code a new value in a page.
4. **REQUIRED SUB-SKILL: `craft-critique` in self-check mode** on every board: render it, fix what it finds within this task's scope, and render again.
4. **Close.**
- Show the result with the summary below.
- Append the decisions to `DESIGN.md` › Decisions log (date, decision, why).
- Move any question that got answered out of Open questions.
## Closing summary (the shape of your final message)
```
Made: <pages/elements> — <where: files or boards>
Decisions: <each, one line with its why> (also in DESIGN.md › Decisions log)
System changes: <pieces or tokens added/changed> — affects: <screens>
Self-check fixed: <what craft-critique changed before you saw it>
Open questions: <what the person still has to decide>
```
## Rules
| Rule | Why |
|---|---|
| `DESIGN.md` first, every time | Without the brief every screen invents its own style |
| Scope confirmed before work when it's more than one item | Three pages built on a wrong reading is three pages wasted |
| States list before drawing (via `craft-states`) | The happy path is one state of many |
| Options only when the direction is open | Options on a solved pattern waste the person's attention |
| Only system pieces and tokens; new ones go through `craft-system` | Hard-coded values in pages are where drift starts |
| Code beats a stale brief; note it, don't override | The tokens are what ships; the brief is updated by decision, not silently |
| Self-check before showing | The person should review design, not catch mistakes |
| Decisions go into `DESIGN.md` | Next session's design starts from them, not from memory |
## Done when
Every item in the confirmed scope has its states drawn and self-checked, any system change has gone through `craft-system`, the closing summary has been given, and `DESIGN.md`'s Decisions log has been updated.
## Common mistakes
| Thought | Reality |
|---|---|
| "Three pages are clear enough, I'll just build them" | Confirm the list first. It costs one message. |
| "I'll make buttons 52px here; the token says 44, but this audience needs bigger" | That's a system decision. Propose it through `craft-system`, then use it everywhere. |
| "The brief says teal, so I'll override the blue in this page's CSS" | Code wins. Flag the conflict and ask; never patch tokens locally. |
| "I'll show it, they'll tell me what's wrong" | Run `craft-critique` in self-check first, and say what it fixed. |
| "The decisions are in my message, that's enough" | Messages scroll away. Append them to `DESIGN.md`. |
| "This session can't stop for answers, so I'll make the calls myself and list them" | Ending your turn with the question *is* stopping. Do that; build nothing past the first open stop. |
| "To save a round trip I'll put both stops in one message" | Fine, if you then stop. Ask both, build nothing, wait. |
© Diego Fernandes · MIT · diego3g/craft
Similar skills
All skills for Design →craft by other authors comes first.