Compact the current conversation into a handoff document for another agent to pick up, referencing existing artifacts (PRDs, plans, ADRs, issues, commits, diffs) by path or URL instead of duplicating them. Use whenever the user wants to hand off to a fresh agent, is ending a session mid-task, asks for a handoff doc or a summary of state, decisions and next steps for the next session, or starts a new session that picks up prior work.
A source-grounded starter task has not been verified for this skill yet.
SKILL.md
name: handoffdescription: "Compact the current conversation into a handoff document for another agent to pick up, referencing existing artifacts (PRDs, plans, ADRs, issues, commits, diffs) by path or URL instead of duplicating them. Use whenever the user wants to hand off to a fresh agent, is ending a session mid-task, asks for a handoff doc or a summary of state, decisions and next steps for the next session, or starts a new session that picks up prior work."argument-hint: "What will the next session be used for?"license: MITmetadata: derived_from: "https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff" original_author: "Matt Pocock (@mattpocock)" original_license: MIT voice: "Matt Pocock — no-duplication, reference-existing-artifacts, tailored to next-session focus" version: 1.0.0
Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by mktemp -t handoff-XXXXXX.md (read the file before you write to it).
Suggest the skills to be used, if any, by the next session.
Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
Sections
Goal of next session (from user argument or inferred)
State of play (what's done, what's blocking)
Open decisions (what the next agent must decide)
Skills to use (concrete list)
Artifacts (paths/URLs to PRDs, plans, ADRs, issues, branches, PRs — do not duplicate)