SkillsBot.org

Brainstorming Skill (Superpowers)

The first step of the Superpowers workflow. Before building anything new, Claude finds out what you actually want and why, lays out approaches, and writes a short design for you to approve.

Part of the Superpowers collection.

  • License MIT
  • Installs 431K
  • GitHub stars 318.0K
  • Audits 3 of 3 passed

Our hands-on test, by SkillsBot.org

We told Claude “I want to add a dark mode to my blog”

The brainstorming skill did what it says: before touching anything, Claude read the blog, asked one question, why dark mode and why now, and offered a recommendation for each answer. After we accepted its recommendation it built the smallest version: an automatic dark theme in CSS, no button, no JavaScript. Without the skill Claude built straight away: a toggle button, saved preferences and a no-flash script; then, on our second message, it tested in headless Chrome and committed to a new git branch nobody asked for.

  • InstallWorked2 s with the skills CLI
  • Picked up on its ownYesinvoked brainstorming
  • Time25 s4 min 14 s without the skill
  • API cost$0.27$0.45 without the skill

The task, word for word

I want to add a dark mode to my blog in this folder. → then: “Go with your recommended answers to everything, and continue.”

With the skill

Two turns with the brainstorming skill: a question about why dark mode is wanted, then a small CSS-only change

Without the skill

Two turns without the skill: a full dark mode with toggle built immediately, then testing and a commit to a new branch
Both conversations. With the skill the first reply is a question; without it the first reply is a finished feature. Full size: with the skill, without.

What it actually did

  1. Invoked brainstorming on a one-line request, then read every file in the project before asking anything.
  2. Asked a single question about the reason for dark mode, with a recommended path for each likely answer and an offer to skip ahead.
  3. Judged the work small, so it skipped a written design document, as the skill's “size the work” section allows.
  4. Implemented only what the chosen path needed: CSS variables with a prefers-color-scheme dark set and a color-scheme meta tag (4 lines changed).

Where it helped

  • Asked about the goal before choosing a solution, and the question was a useful one.
  • Built the least code that met the need, and left an obvious next step (a toggle) for later.
  • Did not commit or create branches on its own.
  • Cheap: about $0.27 for both turns.

Limits we hit

  • It did not open the page in a browser to check the dark colours; the run without the skill did.
  • For a request this small, the extra round trip can feel like friction; reply “just do it” to skip the questions.
  • Designed to lead into the rest of Superpowers (writing-plans and onwards); on its own you get the conversation, not the planning workflow.

Use it for

  • Feature requests that are one line long but hide real choices.
  • Planning anything new before code is written, in software or outside it.
  • Teams that want the agent to confirm direction before it changes files.
  • Install the rest of obra/superpowers to continue into plans and implementation.

One run with the skill and one without, same prompt, fresh folders, Claude Code 2.1.325 in headless mode. How we test skills. Every skill we have tested.

Last updated . The brainstorming skill is made and maintained by Jesse Vincent; SkillsBot.org is an independent directory and is not affiliated with it.

Use brainstorming in Codex, Cursor and GitHub Copilot

brainstorming is a standard Agent Skills folder, so the same files work in other coding agents. Name the agent when you install:

Parts of a skill that rely on Claude Code features, such as subagents or / commands, may behave differently elsewhere. Paths for each agent are in our install guide.

Brainstorming Skill (Superpowers) facts

Author
Jesse Vincent (@obra)
Repository
obra/superpowers
License
MIT
Installs
431K
GitHub stars
318.0K
First seen on skills.sh
Jan 19, 2026
SKILL.md length
2,620 words
Other files
7

Security audits on skills.sh:

Installs, stars, first-seen date and audits from skills.sh on November 16, 2026. SKILL.md read from GitHub the same day.

What the brainstorming skill does

The skill opens with a blunt observation: Claude is good at building what it believes you want, and that belief is usually thinner than it feels. So before implementing anything that is not fully specified, it must:

  1. Lay out the possible approaches and have you pick one.
  2. Write a design document, short or full depending on the size of the work.
  3. Get your approval of that document.
  4. Hand over to the Superpowers writing-plans skill.

If the request already contains everything that matters ("make the icon cornflower blue"), Claude just does it.

How the conversation goes

It tells Claude to look at the project and any context you gave before asking questions, play its understanding back to you, and watch for red flags such as building before the design is agreed. An optional visual companion opens a browser tab with mockups, diagrams and prototypes when seeing beats reading; the scripts in the folder run it.

Part of a set

Brainstorming works best with the rest of Superpowers: writing-plans, executing-plans or subagent-driven-development, test-driven-development and verification-before-completion. Install the whole repository to get them all.

What is in the brainstorming folder

  • SKILL.mdinstructions
  • builder-check-prompt.md
  • visual-companion.md
  • scripts/5 files

Brainstorming Skill (Superpowers): FAQ

What is Superpowers for Claude Code?

Superpowers (obra/superpowers) is a collection of connected skills that give Claude Code a full development workflow: brainstorm, plan, implement with tests, review and verify.

Will brainstorming slow down small tasks?

The skill tells Claude to skip the questions when the request already says everything that matters, and you can opt out of the questions at any time.

How do I install all of Superpowers?

Run npx skills add obra/superpowers and choose the skills you want, or check the Superpowers repository for its own plugin install instructions.