About handoff-spec
A handoff skill for transferring specification work to another machine or agent. It updates the specification’s existing handoff with decisions, progress, next steps, and outstanding risks so a fresh session can continue, then pushes the changes.
Key features
- 01Updates the existing specification handoff
- 02Records progress and exact stopping point
- 03Captures decisions and pending questions
- 04Notes broken or unverified work
- 05Pushes the updated handoff
Use cases
- 01Move specification work to another agent
- 02Resume work on a separate machine
- 03Prepare a cold-start continuation from the repository
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/handoff-specin Claude Code to confirm it loaded.
Details
From the project READMEHandoff Spec
I'm moving this spec's work to another machine or another agent. The next session starts cold: it has the repository and nothing else. It has none of this conversation, none of this machine's files and none of your memory. Leave the spec so that session can carry on as if it had been here.
Collect what this session knows and the spec doesn't yet say, from the discussion and from the work itself, and put it in the spec:
- what is done, what is half-done and exactly where it stopped, and what is next;
- what I decided or corrected along the way, and how I want the work done;
- calls you made where I was silent, and anything still waiting on me;
- what is known to be broken or unverified, with what you already found out about it;
- anything that lives only on this machine and the next session needs: unpushed branches, uncommitted work, scratch results worth keeping.
Write it into the spec's own handoff, in place: the spec stays one current account, not a transcript with a new note on top. Then push, so everything the spec points at exists on the remote.
Done when a fresh agent, given only the repository, would pick the same next step you would, and would not repeat a question I've already answered.