SKILL.md
Cross-Agent Handoff
Transfer the minimum sufficient state for another capable worker to continue safely and verify independently.
Rules
- Treat the repository, filesystem, and current harness as authoritative; the handoff is a routing map, not proof.
- Never include secrets, access tokens, private environment dumps, or unnecessary personal information.
- Separate verified facts, inferences, recommendations, and unverified claims.
- Record permissions and prohibited actions. A handoff cannot grant authority the sender did not have.
- For concurrent writers, assign non-overlapping ownership or separate worktrees and name the integration owner.
- Link durable artifacts and exact paths; do not paste large transcripts when a file or commit is available.
Produce a handoff
Use [handoff-template.md](references/handoff-template.md). Include:
- objective and acceptance criteria
- repository, worktree, branch, base commit, and current commit
- user instructions and applicable project instructions
- authorized, forbidden, and approval-gated actions
- verified state, exact commands, outputs, and artifact paths
- changed files and why they changed
- decisions, alternatives rejected, and assumptions
- failures, blockers, risks, and remaining uncertainty
- one concrete next action and its success condition
Keep current state separate from historical narrative. Put stale or superseded information in a clearly marked history section.
Consume a handoff
Before acting:
- re-read current project instructions
- confirm repository, branch, commit, dirty state, and untracked files
- verify the most consequential cited evidence
- detect drift since the handoff was written
- confirm that the requested next action remains authorized
If reality disagrees with the handoff, preserve the conflicting evidence and follow current reality. Do not silently rewrite history.
Completion receipt
When handing back, state:
- what changed since receipt
- checks run and exact results
- repository and external-system state
- remaining work and its owner
- whether any commit, push, merge, deploy, message, deletion, spend, or permission change occurred