Skip to content
Back to search

craft

MarketplaceWorks with Claude CodeGitHub

Design skills for AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 16 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/diego3g/craft with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/diego3g/craft'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/diego3g--craft/badge.svg)](/listings/diego3g--craft)

HTML

<a href="/listings/diego3g--craft"><img src="/api/listings/diego3g--craft/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code, Claude Desktop and claude.ai

Install craft as a plugin. Inside a Claude Code session:

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

- The plugin adds a session-start hook, so every request goes to the right skill by itself. - Skills carry the plugin name: `/craft:craft`, `/craft:craft-setup` and so on. - Update from your shell with `claude plugin update craft@craft`.

In Claude Desktop or claude.ai, go to Customize › Plugins › Add › Add marketplace, then enter `diego3g/craft`.

Codex, OpenCode, Cursor and other agents

Install the skills with the [skills CLI](https://skills.sh):

npx skills add diego3g/craft

It asks which agents to install into. You can also name the agent yourself:

| Agent | Command | |---|---| | Codex | `npx skills add diego3g/craft -a codex` | | OpenCode | `npx skills add diego3g/craft -a opencode` | | Cursor | `npx skills add diego3g/craft -a cursor` | | Gemini CLI | `npx skills add diego3g/craft -a gemini-cli` | | GitHub Copilot | `npx skills add diego3g/craft -a github-copilot` | | Windsurf | `npx skills add diego3g/craft -a windsurf` |

- Add `-g` to install for every project instead of only the current one. - Run `npx skills update` to update later.

These agents don't run the session-start hook. Paste the routing below into your `AGENTS.md` so the agent still picks the right skill.

<details> <summary><b>Routing for AGENTS.md</b></summary>

## Design skills
Before responding to anything that designs, reviews or changes a UI, check this table and use the skill.
First look whether DESIGN.md exists at the project root.
- No DESIGN.md and a design task → craft-setup, then craft
- Design / create / redesign a page, screen, flow or element → craft
- "Options", "alternatives", "I don't like it" → craft-explore
- "Review", "refine", "make it better", or before showing your own design → craft-critique
- Tokens, style guide, a component, "audit" → craft-system
- "Bring our design system into <tool>", "apply the guide changes to the code" → craft-sync
- "What states are missing?" → craft-states
Small edits the person described exactly (one value, label or size): just make them.
A stop means ending your turn with the question. Never decide a stop for the person.

</details>

**By hand:** copy the folders in `skills/` into your project's `.agents/skills/`, then add the routing above.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "craft",
  4. "description": "Design skills for AI agents.",
  5. "owner": {
  6. "name": "Diego Fernandes"
  7. },
  8. "plugins": [
  9. {
  10. "name": "craft",
  11. "description": "A design workflow that starts by itself: setup interview, /craft:craft, states, options, design system and self-critique.",
  12. "source": "./",
  13. "category": "design"
  14. }
  15. ]
  16. }
README.md · README · 141 lines
  1. <p align="center">
  2. <img src="assets/banner.png" alt="craft" width="100%">
  3. </p>
  4. <p align="center">
  5. <b>Design skills for AI agents.</b> Complete screens with every state, and a design system that stays consistent.<br>
  6. Works with Paper, Figma or plain HTML, in Claude Code, Codex, OpenCode, Cursor and other agents.
  7. </p>
  8. <p align="center">
  9. <a href="https://skills.sh/diego3g/craft"><img src="https://skills.sh/b/diego3g/craft" alt="skills.sh"></a>
  10. </p>
  11. ---
  12. Ask your agent for "a pricing page" and, with craft installed, it works like a careful designer:
  13. - it writes a short design brief first;
  14. - it lists every state the screen can be in;
  15. - it uses your design system's pieces;
  16. - it checks its own work before showing it.
  17. It stops for your "yes" where it matters and writes its decisions down for next time.
  18. ## Install
  19. ### Claude Code, Claude Desktop and claude.ai
  20. Install craft as a plugin. Inside a Claude Code session:
  21. ```
  22. /plugin marketplace add diego3g/craft
  23. /plugin install craft@craft
  24. ```
  25. - The plugin adds a session-start hook, so every request goes to the right skill by itself.
  26. - Skills carry the plugin name: `/craft:craft`, `/craft:craft-setup` and so on.
  27. - Update from your shell with `claude plugin update craft@craft`.
  28. In Claude Desktop or claude.ai, go to Customize › Plugins › Add › Add marketplace, then enter `diego3g/craft`.
  29. ### Codex, OpenCode, Cursor and other agents
  30. Install the skills with the [skills CLI](https://skills.sh):
  31. ```
  32. npx skills add diego3g/craft
  33. ```
  34. It asks which agents to install into. You can also name the agent yourself:
  35. | Agent | Command |
  36. |---|---|
  37. | Codex | `npx skills add diego3g/craft -a codex` |
  38. | OpenCode | `npx skills add diego3g/craft -a opencode` |
  39. | Cursor | `npx skills add diego3g/craft -a cursor` |
  40. | Gemini CLI | `npx skills add diego3g/craft -a gemini-cli` |
  41. | GitHub Copilot | `npx skills add diego3g/craft -a github-copilot` |
  42. | Windsurf | `npx skills add diego3g/craft -a windsurf` |
  43. - Add `-g` to install for every project instead of only the current one.
  44. - Run `npx skills update` to update later.
  45. These agents don't run the session-start hook. Paste the routing below into your `AGENTS.md` so the agent still picks the right skill.
  46. <details>
  47. <summary><b>Routing for AGENTS.md</b></summary>
  48. ```markdown
  49. ## Design skills
  50. Before responding to anything that designs, reviews or changes a UI, check this table and use the skill.
  51. First look whether DESIGN.md exists at the project root.
  52. - No DESIGN.md and a design task → craft-setup, then craft
  53. - Design / create / redesign a page, screen, flow or element → craft
  54. - "Options", "alternatives", "I don't like it" → craft-explore
  55. - "Review", "refine", "make it better", or before showing your own design → craft-critique
  56. - Tokens, style guide, a component, "audit" → craft-system
  57. - "Bring our design system into <tool>", "apply the guide changes to the code" → craft-sync
  58. - "What states are missing?" → craft-states
  59. Small edits the person described exactly (one value, label or size): just make them.
  60. A stop means ending your turn with the question. Never decide a stop for the person.
  61. ```
  62. </details>
  63. **By hand:** copy the folders in `skills/` into your project's `.agents/skills/`, then add the routing above.
  64. ## The skills
  65. | Skill | What it does |
  66. |---|---|
  67. | **`craft-setup`** | Interviews you one question at a time: product, audience and voice, mood, brand, references, constraints. It then writes `DESIGN.md` and builds the foundations (tokens and base components). |
  68. | **`craft`** | The main command, for designing a page, screen, flow or element. It confirms the scope, then for each screen lists the states, draws with your system's pieces and checks the result. |
  69. | **`craft-states`** | Lists every state a screen can be in (empty, loading, error, long content, permissions, offline…) using realistic messy data, then draws and names each one. |
  70. | **`craft-explore`** | Draws three directions that really differ in structure, interaction or density, never just new colours. They sit next to the current design, with a recommendation first. |
  71. | **`craft-system`** | Looks after the design system: role-named tokens, interaction rules defined once, a states matrix per component, and a component index. Before a change spreads, it lists the screens the change affects. |
  72. | **`craft-sync`** | Brings a design system that already lives in code into your design tool. Later it sends the guide's changes back to the code as a reviewed diff. |
  73. | **`craft-critique`** | Renders the design and looks at it, then checks hierarchy, spacing, contrast, text, consistency and motion. Findings are ranked by impact. In review mode it changes nothing. |
  74. The hidden `using-craft` skill does the routing: it sends each request to the right skill.
  75. Agents with slash commands run them by name: `/craft`, `/craft-setup`… (`/craft:craft`, `/craft:craft-setup`… with the Claude Code plugin). In any agent you can also just ask in plain words.
  76. ## The best workflow
  77. 1. **Start with the brief.** Run `craft-setup` once per project. It writes `DESIGN.md`, which every other skill reads first. If your repo already has a component library or token files, `craft-setup` offers `craft-sync` instead, so nothing gets invented twice.
  78. 2. **Design with `craft`.** Describe what you need ("a settings page with billing and team"). It stops to confirm the scope and the list of states, then draws.
  79. 3. **Unsure about the direction?** Say "give me options" and `craft-explore` draws three directions. Pick one, or mix two.
  80. 4. **Review before you ship.** Say "review this" for a `craft-critique` report. `craft` already runs this check on its own work before showing it.
  81. 5. **Keep the system healthy.** Ask for "an audit" from time to time (`craft-system`). After changing the guide in your design tool, say "apply the guide changes to the code" (`craft-sync`).
  82. Small edits ("make the button 2px taller") skip all of this: the agent makes the change, and says so when it touches a shared piece.
  83. ## Good to know
  84. - **`DESIGN.md`** has eight short sections: Product, Audience and voice, Mood, Brand, References, Constraints, a dated Decisions log and Open questions. It's how Monday's decisions survive into Thursday's session.
  85. - **Your project wins.** Every rule about *look* is a default. If your design system does something else, the agent follows yours.
  86. - **Some rules hold in every project**, because they're about process, not taste:
  87. - cover the states;
  88. - stop for approval;
  89. - give options that really differ;
  90. - make every colour a token;
  91. - use one icon set;
  92. - change design and code together.
  93. - **Tool-agnostic.** The skills describe actions ("create a board", "render and look"), and adapters map them to Paper (MCP), Figma (MCP) or plain HTML. Plain HTML is also the fallback. The Figma adapter hasn't been tested yet, so reports are welcome.
  94. ## Contributing
  95. ```
  96. npm test # validator and hook tests
  97. npm run check # skill format, links, no tool names outside adapters
  98. ```
  99. Every skill was written test-first: scenarios ran without the skill, then with it (see [`tests/scenarios/`](tests/scenarios/)). Changes to a skill should come with a scenario that fails before the change and passes after it.
  100. ## Credits
  101. The session-start hook and the "one entry skill that routes to the rest" idea come from [obra/superpowers](https://github.com/obra/superpowers) (MIT). The banner uses [Departure Mono](https://departuremono.com) (OFL).
  102. ## License
  103. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.