brainstorm · superclaude-org — Claude Code skill: requirements discovery by asking
Switches the agent into brainstorming mode: it asks probing questions until the requirements are clear, then lays out the options side by side.
npx skills add SuperClaude-Org/SuperClaude_Framework --skill brainstorm -a claude-codeWhat brainstorm does
The skill kicks in when a request is vague, like "I want an app for tracking expenses" with nothing behind it. Instead of jumping into code, the agent works through Socratic questions: what problem are you solving, who are the users, what constraints on time and stack, what does success look like. It asks rather than assumes.
From there it diverges. You get several options, each with pros, cons, an effort estimate and a risk level, and only then does it help you converge on one. The skill is a single instruction file: five approach steps plus an output template with the option blocks and a recommendation section. No scripts, no external dependencies.
Worth knowing before you install: it writes no code and does not test whether your ideas hold up. If you already know what you want built, the mode just slows things down — call it deliberately.
What it helps with
- turn a vague brief into concrete requirements
- compare several architecture options before starting
- surface a client's time and stack constraints
- assess the risk of not doing the work
- pick one option and justify the choice
Example prompts for the agent
- Help me think through an expense tracker, ask me questions first
- I want to add auth but haven't decided how — lay out the options
- Gather requirements for a new API and suggest approaches
How to install brainstorm
1Skills CLI (Vercel)
npx skills add SuperClaude-Org/SuperClaude_Framework --skill brainstorm -a claude-code2Manually: put the files in place
~/.claude/skills/brainstorm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/brainstorm/
1Skills CLI (Vercel)
npx skills add SuperClaude-Org/SuperClaude_Framework --skill brainstorm -a codex2Manually: put the files in place
.agents/skills/brainstorm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add SuperClaude-Org/SuperClaude_Framework --skill brainstorm -a cursor2Manually: put the files in place
.cursor/skills/brainstorm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install SuperClaude-Org/SuperClaude_Framework brainstorm2Manually: put the files in place
.github/skills/brainstorm/SKILL.md1Skills CLI (Vercel)
npx skills add SuperClaude-Org/SuperClaude_Framework --skill brainstorm -a gemini-cli2Platform CLI
gemini skills install https://github.com/SuperClaude-Org/SuperClaude_Framework --path plugins/superclaude/skills/brainstormManually: put the files in place
.devin/skills/brainstorm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add SuperClaude-Org/SuperClaude_Framework --skill 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 brainstorm
How do I install brainstorm in Claude?
Run npx skills add SuperClaude-Org/SuperClaude_Framework --skill brainstorm -a claude-code. The skill file lands at ~/.claude/skills/brainstorm/SKILL.md.
What does brainstorm do?
It activates brainstorming mode: the agent asks about the problem, users and constraints, then presents multiple options with pros, cons, effort and risk.
Does the skill need anything installed first?
No. It is a text instruction file with an output template, and it pulls in no libraries or API keys.
Source text
SKILL.md · MIT
--- name: brainstorm description: Activate brainstorming mode for collaborative discovery and creative problem-solving. Use when users have vague requests, want to explore ideas, or need requirements discovery. --- # Brainstorming Mode ## Approach 1. **Ask, Don't Assume**: Use probing questions to uncover requirements 2. **Diverge First**: Generate multiple options before narrowing 3. **Build on Ideas**: Use "Yes, and..." thinking 4. **Visualize**: Use tables, lists, and comparisons 5. **Converge**: Help the user pick the best approach ## Socratic Questions - "What problem are you trying to solve?" - "Who are the users? What do they need?" - "What constraints do we have? (time, budget, tech stack)" - "What does success look like?" - "What are the risks if we don't do this?" ## Output Format Present ideas as structured options: ``` ## Option A: [Name] - Pros: [...] - Cons: [...] - Effort: [Low/Medium/High] - Risk: [Low/Medium/High] ## Option B: [Name] ... ## Recommendation [Which option and why] ``` Apply this to: $ARGUMENTS
© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework
Similar skills
All skills for Agent setup: memory, context, orchestration →brainstorm by other authors comes first.
