handoff
Installation
SKILL.md
handoff
Write a handoff document summarising the current conversation so a fresh agent can continue the work.
Portability, not compression. Reach for this only when the work has to
travel. Staying in the same session, your harness's own in-session
compaction or reset (/compact, /clear in Claude Code) covers the ordinary
end-of-phase case. Five situations are the whole trigger:
| situation | why a file |
|---|---|
| swapping harness (Claude Code → Codex, Antigravity, …) | the new harness cannot see this context |
| moving to another directory or repo | a prototype directory is the common case |
| sending the work to a colleague | they need something they can read cold |
| forking a side task found mid-phase | you keep working; a second agent takes the fork |
a Claude Code cloud session (cloud) |
the cloud machine clones the branch from GitHub — it sees nothing on this machine, and no plugin installed here |