Index of every page on this site: llms.txt
All skills
obra avatar

/brainstorming

@22f0b46 official
by Jesse Vincentobra/superpowers323k stars
28,674
Run it yourself

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).

Use this Skill: https://skilld.dev/gh/obra/superpowers/brainstorming

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

builder-check-prompt.md

≈221 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Builder Check Prompt

Dispatch a fresh general-purpose subagent with this prompt once the written design exists. Fill in the domain and the document path.

You are a talented [DOMAIN, e.g. "software engineer", "event planner",
"bakery consultant"]. You've been handed a design document and asked to
put together a plan to build what it describes. You will not be able to
talk to the person who wrote it.

Read [DOCUMENT_PATH].

Report only the questions you'd still need answered before you could plan
this well: places where you'd have to guess and a wrong guess would
matter. For each, give the question and why the answer changes the plan.
Rank them by importance.

Skip anything the document explicitly leaves to the builder, and anything
you could reasonably decide yourself. Skip nitpicks about wording.

If nothing important is left, say "nothing important left".

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 alert15d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides a structured brainstorming workflow with an optional visual companion. It includes a custom Node.js server to serve mockups to a local browser. The implementation follows security best practices, including session-based authentication, path traversal protection, and secure process management.

  • Socket15d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer8mo

    3/8 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 22f0b46. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated 2 weeks ago
  • Design
  • brainstorming
  • requirements
  • planning
  • specification
  • collaboration
  • workflow

README badge

README badge for obra/superpowers/brainstorming

Enforces a structured brainstorming process before any implementation work: explores project context, asks clarifying questions one at a time, proposes 2-3 design approaches, presents a design for user approval, and writes a spec document to `docs/superpowers/specs/`. Prevents coding, scaffolding, or any implementation action until design approval is complete.

Generated from the current SKILL.md.

Does this skill write code or just plan design?
This skill only plans and designs. It has a hard gate that prevents any code writing, scaffolding, or implementation until the user approves a written design spec. After approval, it invokes the writing-plans skill to create an implementation plan.
When should I use this skill?
Use this before any creative work — creating features, building components, adding functionality, or modifying behavior. It applies to every project regardless of perceived simplicity, including todo lists and single-function utilities.
What output does this skill produce?
A written design spec saved to `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`, covering architecture, components, data flow, error handling, and testing. The spec is committed to git and reviewed by the user before implementation planning begins.
Does this skill handle large projects with multiple subsystems?
If a project describes multiple independent subsystems, the skill flags this immediately and helps decompose it into sub-projects. Each sub-project gets its own design spec, implementation plan, and build cycle.
Can this skill create visual mockups?
Yes, via an optional Visual Companion tool that renders mockups, diagrams, and layout comparisons in a browser. The skill offers it only when visual content would help clarify upcoming questions.

Generated from the current SKILL.md. These answers refresh after source changes.