01-brainstorm — Claude Code skill: ideas and setup
The 01-brainstorm skill clarifies a rough idea through questions, then turns the discussion into a short brief. Use it when a request is ambiguous or you want to explore an idea together.
MIT ★ 571 updated 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-refine@aidd-frameworkWhat 01-brainstorm does
The skill moves an idea through capture, exploration, and conclusion. It asks questions when the answers could change the outcome, then writes a brief in the chat once the idea is clear or the user wants to stop. After asking questions or offering ways to keep the result, it waits for a reply.
Its workflow is defined in actions/01-capture.md, actions/02-explore.md, actions/03-conclude.md, and references/persistence.md; each file provides instructions for a stage. This skill does not plan work or write code, so the result is a brief rather than an implementation plan.
What it helps with
- clarify a fuzzy idea through questions
- resolve ambiguity before starting work
- turn discussion into a concise brief
- explore options when an idea is still taking shape
Example prompts for the agent
- Help me clarify an idea for adding shared shopping lists to my app.
- Ask questions that could change the outcome as we explore this feature idea.
- Write a short brief from our discussion about the new feature.
How to install 01-brainstorm
1Plugin marketplace
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-refine@aidd-frameworkThis installs the whole aidd-refine plugin with all its skills
2Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-brainstorm -a claude-code3Manually: put the files in place
~/.claude/skills/01-brainstorm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/01-brainstorm/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-brainstorm -a codex2Manually: put the files in place
.agents/skills/01-brainstorm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-brainstorm -a cursor2Manually: put the files in place
.cursor/skills/01-brainstorm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-refine/skills/01-brainstorm2Manually: put the files in place
.github/skills/01-brainstorm/SKILL.md1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-brainstorm -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-refine/skills/01-brainstormManually: put the files in place
.devin/skills/01-brainstorm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 01-brainstorm -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 01-brainstorm
How do I install 01-brainstorm in Claude Code?
Add the marketplace with /plugin marketplace add ai-driven-dev/framework, then install the plugin with /plugin install aidd-refine@aidd-framework.
What does 01-brainstorm do?
It asks questions to clarify an unfinished idea and produces a short brief in the chat. It does not create a plan or write code.
When does 01-brainstorm ask questions?
It asks only when an answer could affect the outcome. After questions or an offer to keep the result, it waits for the user's response.
Source text
SKILL.md · MIT
--- name: 01-brainstorm description: Clarify a vague idea through questions. Use when the user has a half-formed idea, ambiguous request, or asks to brainstorm, discover, refine, or clarify. Not for artifact gap scans, planning, or code. argument-hint: idea --- # Brainstorm ## Actions ```mermaid flowchart LR capture["capture<br>actions/01-capture.md"] --> explore["explore<br>actions/02-explore.md"] explore -->|"ask questions"| user((user answers)) user --> explore explore -->|"clear enough, or user stops"| conclude["conclude<br>actions/03-conclude.md"] conclude -->|"correct: revise, show again"| conclude conclude -->|"explore more"| explore conclude -->|"approve: offer where to keep it"| persist["persistence<br>references/persistence.md"] --> done((done)) ``` Each box is a file: read it, then do what it says. ## Transversal rules - Clarify only: never plan or code. - Ask a question only if its answer changes the outcome. - Talk about the idea, never the skill's steps or files. - After questions, approval or persistence options, wait. - When the user wants to stop or asks for a summary, go to conclude and produce the brief in the chat.
© AI-Driven Dev · MIT · ai-driven-dev/framework