Runs ahead of building a feature or a component and digs into what is actually wanted. It exists because the most expensive agent mistake is building the wrong thing correctly.
In the author’s words
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
The description field from SKILL.md, quoted as written.
Read it before you install it
SKILL.md · 245 lines
Install on its own
Or add it to your stack above and install everything at once.
npx skills add https://github.com/obra/superpowers --skill brainstormingTrust audit
View the source ↗- Checked automatically and confirmed.
- Resolved (HTTP 200), passed
- Checked automatically and confirmed.
- Resolves · 287,591 stars, passed
- Checked automatically and confirmed.
- Transcribed from the author's own page, passed
- Checked automatically and confirmed.
- Last updated 1 months ago, passed
- Checked automatically and confirmed.
- Credited to Jesse Vincent, passed
Goes well with
domain-modeling
Builds and sharpens the project's domain model.
Names the things your codebase talks about and keeps those names honest, through a CONTEXT.md and architecture decision records. Worth reaching for when two parts of the system call the same concept different things.
npx skills add https://github.com/mattpocock/skills --skill domain-modeling
to-spec
Turns the conversation you just had into a spec.
No interview and no questionnaire. It synthesises what has already been discussed into a spec and publishes it to the issue tracker, which is the step most people skip between deciding and building.
npx skills add https://github.com/mattpocock/skills --skill to-spec
PlanningFull page & trust audit →research
Investigates a question against primary sources and files the answer.
Sends the reading legwork to a background agent, restricted to high-trust primary sources, and captures what it found as a Markdown file in the repository so the next person does not repeat it.
npx skills add https://github.com/mattpocock/skills --skill research
PlanningFull page & trust audit →