handoff
Installation
SKILL.md
Write a handoff document so a fresh agent can continue this work without re-reading the full conversation.
Step 1 — Determine the target path
- Check git branch (
git rev-parse --abbrev-ref HEAD). Useno-gitif not in a repo. - Generate a unique filename:
YYYY-MM-DD-HHMM-<branch>.mdusingdate +%Y-%m-%d-%H%M. - Target:
docs/handoffs/<filename>. Create the directory if needed. - If prior handoffs exist, read the most recent (sort by filename) and carry forward still-relevant open questions.
Step 2 — Detect the handoff type
| Signal | Type |
|---|---|
| git repo + edited source files + plan/todos | Code task |
| requirements/, context files, running skill workflow | Document/workflow |
| Neither | Lightweight |