| name | handoff |
| description | Compact the conversation into a handoff document a fresh session can resume from. |
| argument-hint | What will the next session be used for? |
| disable-model-invocation | true |
| version | 1.0.0 |
| source | mattpocock/skills@1.1.0 (handoff) |
Write a handoff document summarising the current conversation so a fresh agent can continue the work.
Save it to the temporary directory of the user's OS — not the current workspace.
A handoff is compaction for resuming work, never a substitute for a spec: decisions that should outlive the session belong in docs/specs/<feature>.md — write them there first, then reference the spec.
- Include a "suggested skills" section naming the skills the next session should invoke.
- Reference artifacts already captured elsewhere (specs, plans, ADRs, commits, diffs) by path or URL rather than duplicating their content.
- Redact sensitive information: API keys, passwords, personally identifiable information.
- If the user passed arguments, treat them as what the next session will focus on and tailor the document accordingly.
End by reporting the document's path so the user can point the fresh session at it.