blueprint-generate — Claude Code skill: what it does, how to install
Ends the Blueprint Q&A interview and writes a structured implementation plan into a dedicated project directory.
npx skills add imbue-ai/blueprint --skill blueprint-generate -a claude-codeWhat blueprint-generate does
This skill takes over once the blueprint Q&A conversation collects enough context. It retrieves the matching template from references/templates.json, builds a 2-5 word kebab-case slug under 50 characters, and creates a directory at blueprint/<slug>. If that folder already exists, it appends -2 or -3 instead of overwriting existing work.
Next, the agent pulls the most recent refined prompt or drafts one using references/refine-prompt.md. During the writing stage, the skill appends a status line ✓ Explore ✓ Plan ● Write ○ Refine to the end of every message, then transitions into refinement.
Running this skill without prior Q&A context breaks the workflow, because the agent cannot resolve the template or feature scope out of thin air.
What it helps with
- turn Q&A interview answers into an actionable engineering plan
- pick the matching feature template from
references/templates.json - organize implementation specs inside an isolated
blueprint/<slug>directory - display phase progress using the built-in status tracker
Example prompts for the agent
- Stop the Q&A session and generate the implementation plan
- We have gathered enough context, create the blueprint plan now
- Wrap up the interview and write the plan to blueprint/<slug>
How to install blueprint-generate
1Skills CLI (Vercel)
npx skills add imbue-ai/blueprint --skill blueprint-generate -a claude-code2Manually: put the files in place
~/.claude/skills/blueprint-generate/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/blueprint-generate/
1Skills CLI (Vercel)
npx skills add imbue-ai/blueprint --skill blueprint-generate -a codex2Manually: put the files in place
.agents/skills/blueprint-generate/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add imbue-ai/blueprint --skill blueprint-generate -a cursor2Manually: put the files in place
.cursor/skills/blueprint-generate/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install imbue-ai/blueprint blueprint-generate2Manually: put the files in place
.github/skills/blueprint-generate/SKILL.md1Skills CLI (Vercel)
npx skills add imbue-ai/blueprint --skill blueprint-generate -a gemini-cli2Platform CLI
gemini skills install https://github.com/imbue-ai/blueprint --path skills/blueprint-generateManually: put the files in place
.devin/skills/blueprint-generate/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add imbue-ai/blueprint --skill blueprint-generate -a opencodeClaude.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 blueprint-generate
How do I install blueprint-generate in Claude Code?
Run npx skills add imbue-ai/blueprint --skill blueprint-generate -a claude-code. You can also configure it directly at ~/.claude/skills/blueprint-generate/SKILL.md.
What does blueprint-generate do?
It closes the exploratory Q&A round, matches a template from references/templates.json, and outputs the implementation plan into blueprint/<slug>.
How does it handle existing plan directories?
If blueprint/<slug> already exists, the skill prevents collisions by appending -2, -3, and subsequent numbers to the directory slug.
Source text
SKILL.md · MIT
--- name: blueprint-generate description: End the Q&A phase and generate the plan. Use after the blueprint skill has gathered enough context. --- ## Blueprint — Generate plan Generate an implementation plan from the Q&A session. ### Step 1: Resolve template Recall the template name from the blueprint Q&A conversation. Read [references/templates.json](references/templates.json) and find the matching template. ### Step 2: Generate slug Create a concise 2-5 word kebab-case slug (max 50 chars) for the feature. Sanitize: lowercase, alphanumeric + hyphens only, no leading/trailing hyphens. If `blueprint/<slug>` already exists, append `-2`, `-3`, etc. ### Step 3: Create plan directory ```bash mkdir -p blueprint/<slug> ``` ### Step 4: Refine the prompt Use the most recent refined prompt from the Q&A conversation. If for any reason it wasn't shown during Q&A, generate it now — see [references/refine-prompt.md](references/refine-prompt.md). ### Step 5: Write the plan See [references/write-plan.md](references/write-plan.md). Append this progress line at the end of **every** message during the Write phase: ``` ✓ Explore ✓ Plan ● Write ○ Refine ``` Place the line after all other content, separated by a blank line. ### Step 6: Refinement See [references/refinement.md](references/refinement.md).
© imbue-ai · MIT · imbue-ai/blueprint
