Name: implement-spec
Author: mattpocock

About

Imported from mattpocock/skills (skills/in-progress/implement-spec/SKILL.md) via skills.sh. Install upstream with npx skills add mattpocock/skills --skill implement-spec. Copyright stays with the author.

You have been provided a spec. This spec should have tickets associated with it, describing how to implement the spec.

The goal is a PR which implements the entire spec on a single branch.

The tickets are not a list of steps. They are a task graph with blocking relationships between them. This means there is always a frontier of tickets which are ready to be grabbed.

Communication to and from subagents should be sparse. Communicate primarily through context pointers: to the spec, tickets, research notes, and previous commits. Don't duplicate information already available via pointers.

Implementer subagents should be run in the background where possible for maximum concurrency.

Steps

Read the spec and tickets. Read enough to understand the task graph.
(optional) Use an exploration subagent to conduct any exploration required by the tickets - relevant codebase files or external documentation. Ensure the exploration subagent can save files - it should save its markdown notes in a directory outside the repo, accessible by all future subagents. This lets implementer subagents focus on implementation rather than exploration.
Create a branch, and a draft PR. The PR should be marked as 'closing' the spec issue and tickets.
Use implementer subagents to implement each ticket. Each implementer subagent should work in its own worktree, on its own branch.
Once an implementer subagent completes, merge its work to the PR branch with a merger subagent.
If this changes the frontier of available tickets, kick off more implementer subagents to work on the new tickets. This allows for maximum concurrency.
Once all tickets are complete, run /code-review on the PR branch. Fix all issues raised by the code review in a single implementer subagent.
Mark the PR as ready for review.
Clean up all implementer subagent worktrees.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/mattpocock-skills-implement-spec/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

mattpocock-skills-implement-spec.ocm.jsonjson

{
  "ocm": "1",
  "id": "mattpocock-skills-implement-spec",
  "kind": "skill",
  "name": "implement-spec",
  "description": "Implement a specification in code.",
  "publisher": "mattpocock",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Implement a specification in code."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/mattpocock/skills",
      "path": "skills/in-progress/implement-spec/SKILL.md",
      "ref": "HEAD",
      "url": "https://www.skills.sh/mattpocock/skills/implement-spec",
      "key": "mattpocock/skills/skills/in-progress/implement-spec/SKILL.md"
    }
  },
  "instructions": "You have been provided a spec. This spec should have tickets associated with it, describing how to implement the spec.\n\nThe goal is a PR which implements the entire spec on a single branch.\n\nThe tickets are not a list of steps. They are a **task graph** with blocking relationships between them. This means there is always a **frontier** of tickets which are ready to be grabbed.\n\nCommunication to and from subagents should be sparse. Communicate primarily through **context pointers**: to the spec, tickets, research notes, and previous commits. Don't duplicate information already available via poi",
  "cost": {
    "context_tokens": 482
  }
}

Fetch it by URL: GET /api/v1/registry/mattpocock-skills-implement-spec/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.