Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add diego3g/craft
/plugin install craft@craft
Open on GitHub

What 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@craft

This installs the whole craft plugin with all its skills

2Skills CLI (Vercel)

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

3Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/craft/

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.

craft educlopez The craft Claude Code skill builds a complete interface from a surface recipe and checks it against an acceptance bar. It handles requests such as creating a dashboard or landing page. CX Codex +1 594installs ui-craft Pedro Nauck ui-craft — a skill for designing and building visible interfaces: pages, components, forms, loading and error states, AI chat surfaces with streaming. Works within your project's design system and validates accessibility. CX Codex +1 314installs landing-page-design elayadesign landing-page-design — a skill that defines page structure and visual rules for landing pages: intake questions, section order, copywriting and a strict design system. It applies whenever an agent builds or edits any landing page. CX Codex +1 6,900installs wireframe ghaida wireframe — a skill that designs screen structure in grayscale — what sits where and why, before visual design starts. CX Codex +1 3,000installs high-contrast-skeuomorphic-clean MengTo high-contrast-skeuomorphic-clean defines rules for building high-contrast, tactile dark interfaces with molded panels and restrained accents. Useful when designing industrial UI systems. CX Codex +1 1,800installs ui-design TencentCloudBase The ui-design skill guides visual decisions and asks the agent to write a design specification before coding. Use it for web interfaces, mini programs, and prototypes. CX Codex +1 1,800installs teslers-law Owl-Listener Applies Tesler's Law to help you balance complexity between the interface and the user. Useful when designing forms, multi-step flows, and settings. CX Codex +1 1,400installs

From the same set9

using-craft The using-craft Claude Code skill routes interface design work to the right Craft skill. For a new page, it checks whether the project root contains DESIGN.md. CX Codex +1 ★ 393repo stars craft-explore The craft-explore Claude Code skill creates alternative designs for a screen, flow, or interface element. It activates when someone asks for options or rejects the current design. CX Codex +1 ★ 393repo stars craft-states The craft-states Claude Code skill maps the states a screen, flow, or component needs. It runs during design or redesign and before a screen is handed to development. CX Codex +1 ★ 393repo stars craft-critique The craft-critique Claude Code skill reviews a rendered screen and can apply focused design fixes. It activates for critique or polish requests, before a screen is shown, or before a design goes to code. CX Codex +1 ★ 393repo stars craft-setup craft-setup — a skill for Claude Code that gathers product design decisions and records them in DESIGN.md. It starts before a design task when the project root has no brief yet. CX Codex +1 ★ 393repo stars craft-system craft-system — a skill for Claude Code builds and updates design systems, then checks guides and screens for inconsistencies. It activates for work on tokens, components, or UI audits. CX Codex +1 ★ 393repo stars craft-sync The craft-sync Claude Code skill moves design tokens and selected components between a codebase and a design tool. It activates before a design task or when asked to import a system or sync guide changes back to code. CX Codex +1 ★ 393repo stars craft This Claude Code plugin routes interface design requests to skills for screen states, design exploration and review. Ask for a new or revised UI, and craft selects a workflow. ★ 393repo stars

Project sponsors

Companies that keep this analytics open