session-handoff
Installation
SKILL.md
Session Handoff
Two modes sharing one state contract. HANDOFF packages current work so the next agent (or future session) resumes without re-discovery. PICKUP rehydrates from that package at session start. Pick the mode from intent: ending or pausing work = HANDOFF; starting on existing work = PICKUP.
Mode: HANDOFF
Produce a concise bullet package with these sections, in order. Every claim comes from a command you ran this session — re-run when stale, because a wrong handoff costs more than no handoff.
- Scope/status — the task in one line, finished vs. remaining work, blockers.
- Working tree —
git status -sbsummary; note local commits not yet pushed and whether you are in a worktree (pwdcontains.claude/worktrees/). - Branch/PR — current branch, PR number/URL, CI status (
gh pr checks <num>when a PR exists). - Live processes — long-running jobs the next agent must know about: summarize
ps auxww | grep -E '<your-process>', plus a copy-paste attach or log-tail command (tail -f <logfile>,jobs -l). Redact secrets in command lines. - Tests/checks — which commands ran, results, what still needs to run.
- Next steps — remaining actions in execution order, most urgent first.
- Risks/gotchas — flaky tests, feature flags, brittle areas, approvals still needed.
Gate: every live process has a copy-paste command; every pending step is ordered. Output format: bullet list, Dense-Complete — short enough to paste into a PR comment or session note.