handoff
Installation
SKILL.md
Handoff
Skip when "resume the work in <doc>" already suffices — just hand them that path.
Protocol
Step 1 — Scope the handoffs
Use the request and conversation to choose the prompt count and boundaries:
- Named items. Write one prompt per item, in order; note any sequencing.
- One thread. Write one prompt.
- Ambiguous threads. Use
AskUserQuestionto ask whether to combine or separate them, and list the proposed split.
Step 2 — Locate context to reference, don't restate
- Source. Point
Read first:at the state artifact the workflow already maintains (plan.md,interview.md, spec, or investigation); otherwise reference the source files, commit, or PR. - Delta. Add only missing current status, the last decision, and the next action. Drop completed next actions and tell the new chat to rebuild its task list from the sources.
- Missing owner. If the remaining state cannot fit a lean prompt, use
AskUserQuestionto ask whether and where to create an active-state artifact. Use a location maintained by an existing workflow or chosen by the user; never default toCONTEXT.md.