Skip to content
SkillMixed3,515 tokens in use

brainstorming

Asks what you want and why, lays out approaches, and gets a design doc approved before your agent builds anything.

322,762 stars on the repository MIT Licenseobra/superpowers · skills/brainstorming
/plugin install superpowers@claude-plugins-official
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing brainstorming costs

46tokens idle
3,515tokens in use
6,903tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/helper.js, scripts/server.cjs, scripts/start-server.sh, scripts/stop-server.sh.

Touches

shelldetectedwrites filesdetectedcredentialsdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure19/25
  • Examples3/15
  • Output15/15
  • Size15/15
  • Resources4/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Good
  • Reads credentials−15

    does this on the machine, and the frontmatter does not say so

    scripts/server.cjs, line 133
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/server.cjs, line 451
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/server.cjs, line 537

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity56
  • Maintenance68
  • Community64
  • Maturity36
  • Momentum40

Brainstorming is the Superpowers skill that runs before any creative work. It checks what the agent already knows about your request, asks one question at a time about the biggest open point, and lays out the approaches in a message of their own. Once you pick one, it writes a design document and waits for your approval before the planning skill takes over. Small, clear requests are done directly. Larger projects get a written design that a fresh subagent reads first, so its questions reach you in one round.

What You Get

  • A short opening message that plays back your request and what the agent found in the project
  • Approaches laid out with trade-offs and a recommendation, for you to pick from
  • A design doc saved under docs/superpowers/specs and committed to the repository
  • A builder check by a fresh subagent that surfaces questions before you read the doc
  • An optional browser tab for mockups and diagrams

Common Use Cases

  • Starting a new feature in an existing codebase
  • Planning a project from a one-line idea
  • Shaping a talk, a business or a renovation, since the skill covers work outside software
  • Turning a spec or handoff into a design you have agreed to

What Makes It Unique

Most planning skills jump to a task list. This one spends its effort on the why behind a request, asks one question at a time, and makes approval of a written design a gate. It scales the document to the size of the work and sends it to a fresh subagent that plays the builder before you read it.

Under The Hood

The skill is mostly instructions loaded into the agent’s context, plus a builder-check prompt file and a visual companion. The visual companion starts a small local Node server through shell scripts and serves mockup pages to a browser tab, and a stop script shuts it down. The server creates a random session token, can keep it in an owner-only token file, and requires it before it serves the pages or accepts a socket connection. It writes mockup and event files to disk and can open your browser only when you opt in with an environment variable. The agent writes the design doc into the repository and, with a subagent tool, dispatches a reviewer. The companion page loads the project’s logo from its website with the version number, unless an environment variable turns that off.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers