| name | session-handoff-skill |
| description | Use when the user says "session handoff", "wrap up session", "hand off", "handoff summary", or wants a structured end-of-session summary before clearing context. Produces a chat-only handoff covering decisions, shipped changes, key files, running state, verification steps, deferrals, and open questions so a fresh agent can continue seamlessly. |
Session Handoff
End-of-session summary for /clear. Audience is the next agent, not a stakeholder. Output in chat only.
Sources to pull from
- Plan files referenced this session
- TodoWrite state — in-progress or pending tasks
- Background processes started with
run_in_background — shell IDs matter
- Files created or modified this session
- Memory files written or updated
- Unresolved questions from the conversation
Do NOT grep or git log to rediscover state. Synthesize what happened in this session only.
Output template
# Session Handoff — <one-line title>
## Where it started
<2-3 sentences: what was asked, key constraints>
## Decisions locked + what shipped
- <change> — <why, absolute path>
## Key files for next session
- `<absolute path>` — <why read first>
- Plan file: `<path>` (if applicable)
- Memory files touched: `<paths>` (if any)
## Running state
- Background processes: <shell IDs + command + how to kill> — or "none"
- Dev servers: <url:port> — or "none"
- Open worktrees: <paths> — or "none"
## Verification
- `<command>` — <expected outcome>
## Deferred + open questions
- Deferred: <item> — <why>
- Open: <question> — <context>
## Pick up here
<1-2 sentences: single most likely next action>
Rules
- Chat only — never write to a file, never update memory.
- Never invent state — write "none" for any section or bullet without real content; never omit a section.
- Absolute paths always.
- Plan file goes first in "Key files".
- No emojis, no hype, no retrospectives.
- Background process IDs must include the kill command.
Anti-patterns
- Summarizing only the last few turns
- Relative paths
- Omitting "Running state" because nothing is running — write "none"
- Writing the handoff to a file
- Steps beyond "Pick up here" — the next agent decides
