handoff-spec
Hand a spec that is mid-implementation to another machine or another agent.
Install
npx skills add https://github.com/dzhng/skills/tree/main/skills/engineering/handoff-spec
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install dzhng-skills@llmmart
git clone https://github.com/dzhng/skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole dzhng/skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Handoff 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.
Files (skills)
-
SKILL.md 1.4 KB
--- name: handoff-spec description: Hand a spec that is mid-implementation to another machine or another agent. disable-model-invocation: true --- # Handoff 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.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.