← 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 2 months ago309,686 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 · 309,686 stars, passed
Transcribed from the author's own page, passed
Last updated 2 months 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