Packages the current working context into a structured handoff document that another agent or session can load to continue work without losing state. Captures: current progress, open decisions, blocking issues, relevant files, and next steps.
SkillScore74Maintained
Automatic
◆AI Engineer pack
Last verified 8/27/2026
What it changes
Passed 16 of 22 test cases with the skill, and 8 of 22 without it.
Without skill35%
With skill74%
Checks it passed that the model alone missed
Uses the `/handoff` command.
Includes `--to "test-automator"`.
Includes the `--context` parameter.
and 12 more in the full report
10 fixed7 passed either way5 still failing1 broke
Pass-rate lift
+39 pp
Tokens
-13%
Agent turns
0%
Response time
-21%
Model gemini-3.6-flashMeasured 8/27/2026v117 of 23 cases passed with skill · 22 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 9
Prompt
I am transferring work on the log parser task to another agent. Instead of writing output to `docs/handoff.md` or chat text, what path must the structured handoff file be saved to?
What was checked, without and with the skill
Checked
Without skill
With skill
Specifies saving to `work/handoff-<timestamp>.md`.
Missed
Passed
case-10 · gemini-3.6-flash · 8/27/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md35 linessingle file
/handoff
Transfer context between agents or sessions with structured state preservation.
Packages the current working context into a structured handoff document that another agent or session can load to continue work without losing state. Captures: current progress, open decisions, blocking issues, relevant files, and next steps.
Implementation
Capture state -- current task, progress, decisions made, files modified.
Write handoff -- save to work/handoff-<timestamp>.md.
Notify -- if handing to a specific agent, include routing metadata.
Examples
# Hand off to another agent
/handoff --to "backend-go" --context "Auth flow designed, need implementation"
# Hand off between sessions
/handoff --to session --files "lib/auth.ex, test/auth_test.exs"
# Quick handoff with inline context
/handoff --to "test-automator" --context "Feature implemented, needs test coverage"