← Library

Agent skill

to-spec

Matt Pocock

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.

PlanningUpdated 28 days ago263,533 stars

In the author’s words

Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.

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

Read it before you install it

SKILL.md · 69 lines

Install on its own

Or add it to your stack above and install everything at once.

npx skills add https://github.com/mattpocock/skills --skill to-spec
Source ↗GitHub ↗skills.sh ↗Matt Pocock

Trust audit

View the source ↗
100%verified
Resolved (HTTP 200), passed
Resolves · 263,533 stars, passed
Transcribed from the author's own page, passed
Last updated 28 days ago, passed
Credited to Matt Pocock, 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 →
  • 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

  • writing-plans

    Turns a spec into a plan before anything is touched.

    Jesse VincentPlanning

    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.

    npx skills add https://github.com/obra/superpowers --skill writing-plans

Work with us