Agent skill · Superpowers
/brainstorming Design-first brainstorming before any build
Brainstorming makes the agent find out what you actually want, and why, before it builds anything. It reads the existing project, asks one focused question at a time, lays out two or three approaches for you to pick from, and writes a short or full design document that must be approved before implementation starts.
Works with
- Claude Code
- Codex CLI
- Cursor
- Gemini CLI
- GitHub Copilot CLI
- Devin CLI
- Qwen Code
- Pi
- Antigravity
Used forPlanning and specs
When to use it
- You ask for a new feature, component or behavior change that leaves important details open
- You are planning something non-software, such as a talk or a renovation, and want to think it through
- You hand over a spec or plan and want the agent to confirm its understanding first
How it works
- 1Read the context
The agent studies the code and any files you pointed at so it does not ask questions the project already answers.
- 2Ask about intent
It echoes your request back and asks the single open question that would most change what gets built.
- 3Compare approaches
It presents two or three ways to build it, with trade-offs and a recommendation, and you choose one.
- 4Write the design
It sizes the work and writes a short or full design document, optionally checked by a fresh subagent acting as the builder.
- 5Hand off to planning
Once you approve the document, it moves on to the writing-plans skill.
What it steers the agent away from
- Writing code, scaffolding projects or installing dependencies before you have agreed on a design
- Silent defaults you never had a chance to reject
- Treating a quick throwaway spike as the final build
Install this skill
It installs with the Superpowers pack.
Claude CodeFrom Anthropic's official plugin marketplace.
/plugin install superpowers@claude-plugins-officialClaude Code (Superpowers marketplace)Alternative marketplace that also lists related plugins.
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplaceCodex CLISearch for superpowers in the plugin list and choose Install Plugin; the Codex app has the same entry under Plugins.
/pluginsCursorRun in Cursor Agent chat, or search the plugin marketplace.
/add-plugin superpowersGemini CLIUpdate later with gemini extensions update superpowers.
gemini extensions install https://github.com/obra/superpowersGitHub Copilot CLIRegisters the marketplace, then installs the plugin.
copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplaceDevin CLIUpdate with devin plugins update superpowers.
devin plugins install obra/superpowersQwen CodePick superpowers when prompted.
qwen extensions install obra/superpowersPiLoads the skills plus a small extension that injects the bootstrap at session start.
pi install git:github.com/obra/superpowersAntigravityRun the same command again to update.
agy plugin install https://github.com/obra/superpowersCommands come from the author’s README; check it for changes before you run them.
Questions
Can I skip the questions and just have it build?
Yes. When you did not ask for brainstorming, the agent offers to dive straight in, and if you accept it states its main choices in one line and proceeds.
Does every small change need a full design document?
No. Small changes get a short design that records what you already agreed in conversation; the full written design is for larger projects.
More guides from Superpowers
/subagent-driven-developmentSubagent-driven plan execution with per-task reviewRuns a plan by sending each task to a fresh subagent, reviewing each result.Read the guide →/test-driven-developmentStrict red-green-refactor test-driven developmentEnforces writing a failing test first, then minimal code, then cleanup.Read the guide →
Also in this pack
/diagnosing-superpowersAnalyzes a session transcript to explain what went wrong, with optional bug report.↗/dispatching-parallel-agentsSplits independent tasks across several subagents that work at the same time.↗/executing-plansCarries out an implementation plan inline in one session, with a final review.↗/finishing-a-development-branchChecks tests, then offers to merge, open a PR, keep or discard the branch.↗/receiving-code-reviewEvaluates review feedback critically and verifies it before changing any code.↗/requesting-code-reviewAsks a reviewer to check finished work against the plan and requirements.↗/systematic-debuggingFinds the root cause of a bug in four phases before attempting a fix.↗/using-superpowersTeaches the agent to look for and load matching skills before responding.↗/verification-before-completionRequires running checks and reading their output before claiming work is done.↗/writing-skillsGuides creating, editing and testing new skills before they are used.↗
Summary by trendhub. The skill itself lives in obra/superpowers/skills/brainstorming by Jesse Vincent (MIT); read the full, current text there.