Install Handoff Spec
Pick your agent. Every command is ready to paste.
npx skills add dzhng/skills --skill handoff-specThe open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.
01
Install it
Run the command above, or upload the folder in Claude.
02
Ask naturally
Describe the task. Your agent loads handoff-spec when the request matches its description.
03
Name it if needed
If it does not trigger, say “use the handoff-spec skill”. In Codex, type $handoff-spec.
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.
Tips for Handoff Spec
- • Start a fresh session after installing so your agent picks up the new skill.
- • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
- • If two skills overlap, mention the one you want by name.
Questions about Handoff Spec
What does the Handoff Spec skill do?
Hand a spec that is mid-implementation to another machine or another agent.
How do I install Handoff Spec?
Run "npx skills add dzhng/skills --skill handoff-spec" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.
Does Handoff Spec work in Cursor and Codex?
Yes. Handoff Spec uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.
Is Handoff Spec free?
Handoff Spec is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.
Who made Handoff Spec?
Handoff Spec is published by dzhng in the dzhng/skills repository, together with 29 other skills.







