GuidecraftIntermediateAbout 15 min7 steps
Make your AI agent design screens like a careful designer with craft
For developers and creators who already use an AI coding agent and want it to design screens more carefully. You install craft, write a design brief once, then ask for screens, options and reviews.
Before you start
- Claude Code, or Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot or Windsurf
- A design tool the skills work with: Paper, Figma or plain HTML
- Node.js, so you can run npx (only needed for agents other than Claude Code)
Inside a Claude Code session, add the craft plugin marketplace with the command below. In Claude Desktop or claude.ai, go to Customize › Plugins › Add › Add marketplace and enter diego3g/craft instead.
Paste into Claude Code /plugin marketplace add diego3g/craftInstall craft from that marketplace. The plugin adds a session-start hook, so every request is routed to the right skill by itself. Skills carry the plugin name, such as /craft:craft and /craft:craft-setup.
Paste into Claude Code /plugin install craft@craftFor Codex, OpenCode, Cursor and other agents, run this command in the terminal. It asks which agents to install into. Add -g to install for every project instead of only the current one. These agents don't run the session-start hook, so paste the routing block from the README into your AGENTS.md.
Run in the terminal npx skills add diego3g/craftRun craft-setup. It interviews you one question at a time about product, audience and voice, mood, brand, references and constraints. Then it writes DESIGN.md and builds the foundations (tokens and base components). If your repo already has a component library or token files, it offers craft-sync instead.
Run in Claude Code /craft:craft-setupDescribe what you need. craft confirms the scope and the list of states, then draws with your design system's pieces and checks its own work before showing it. It stops for your yes where it matters.
Example request Design a settings page with billing and team.If you are unsure about the direction, ask for options. craft-explore draws three directions that really differ in structure, interaction or density, next to the current design, with a recommendation first. Before you ship, ask for a review: craft-critique renders the design and ranks findings by impact, and in review mode it changes nothing.
Ask for options Give me options.From time to time, ask for an audit (craft-system). After you change the guide in your design tool, ask the agent to apply the guide changes to the code (craft-sync). Small, exactly described edits, such as making a button 2px taller, skip all of this, and the agent just makes them.
Watch out for
- Agents other than Claude Code don't run the session-start hook. Without the routing block in AGENTS.md, they may not pick the right skill.
- Run craft-setup first. Every other skill reads DESIGN.md first, and a design task with no DESIGN.md is routed to craft-setup.
- To update, run claude plugin update craft@craft from your shell in Claude Code, or npx skills update if you used the skills CLI.
Questions
- Which design tools does craft work with?
- It works with Paper, Figma or plain HTML, in Claude Code, Codex, OpenCode, Cursor and other agents.
- Can I install craft without the plugin system?
- Yes. Copy the folders in skills/ into your project's .agents/skills/ by hand, then add the routing block to AGENTS.md.
- What does craft-states do?
- It lists every state a screen can be in, such as empty, loading, error, long content, permissions and offline. It uses realistic messy data, then draws and names each state.
Sources
Based on
- diego3g/craft (16 Nov)