← Library

Agent skill

writing-plans

Jesse Vincent

For multi-step work, where the failure mode is an agent that starts confidently in the wrong place. It produces a plan you can read and correct while correcting it is still cheap.

PlanningUpdated 1 months ago287,591 stars

In the author’s words

Use when you have a spec or requirements for a multi-step task, before touching code

The description field from SKILL.md, quoted as written.

Read it before you install it

SKILL.md · 166 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 writing-plans
Source ↗GitHub ↗skills.sh ↗Jesse Vincent

Trust audit

View the source ↗
100%verified
Resolved (HTTP 200), passed
Resolves · 287,591 stars, passed
Transcribed from the author's own page, passed
Last updated 1 months ago, passed
Credited to Jesse Vincent, passed

All 5 checks passed when this was last run. Links were last checked on .

Goes well with

  • domain-modeling

    Builds and sharpens the project's domain model.

    Matt PocockArchitecturePlanning

    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

    ArchitecturePlanningFull page & trust audit →
  • to-spec

    Turns the conversation you just had into a spec.

    Matt PocockPlanning

    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

  • research

    Investigates a question against primary sources and files the answer.

    Matt PocockPlanning

    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

Work with us