handoff
Installation
SKILL.md
Handoff
Write a concise handoff document so a fresh agent can continue from the current state without rereading the whole conversation.
When to use
- User asks for
/handoff, "handoff this", "handoff to /prototype", "handoff back", "summarize for next session", or "another agent should continue". - A long planning, prototype, diagnosis, or implementation thread is about to switch focus or end.
- A side quest should run in another session and return with a compact verdict.
Process
- Identify the handoff target. If the user passed arguments, treat them as the next session's focus, such as
/prototype,/tdd, or "back to grilling session". - Create
.scratch/handoffs/if needed. - Save the handoff as
.scratch/handoffs/YYYY-MM-DD-<short-slug>.md. Use the current local date and a slug for the target or topic. If a file already exists, append a short numeric suffix rather than overwriting. - Before writing, read any existing file at that path so you do not clobber prior notes.
- Write only the context the next agent actually needs.