handoff
Installation
SKILL.md
Handoff Skill
Write a one-shot handoff note to the next session, in the current working directory.
Purpose
Bridge state across a restart or /exit when a full session log is overkill. The next session's SessionStart hook (handoff-read.sh) reads handoff.md, injects its contents as additional context, then deletes the file. One read, gone.
Use this when:
- You need to restart (e.g., MCP server re-enable, permission change, context pressure)
- You want to hand off mid-task state to the next session without polluting
log/ - A quick note is enough — not a full
/session-close
When NOT to Use
- End of a substantive work session → use
/session-close(proper logs, git commit) - Permanent decisions or learnings → use MEMORY.md with
[LEARN]tags - Cross-project notes → use
.context/agent-messages.md