mcpField
H
handoff

handoff

github.com/borkwebAgent workflows858 installsUpdated 3d ago
Repository

About handoff

handoff is an agent skill for creating a concise continuation document for a fresh agent. It specifies a fixed eight-section structure, secure temporary storage, and context needed to resume work without assuming orchestration defaults.

Key features

  1. 01Creates handoff.md in a secure temporary directory
  2. 02Uses a fixed eight-section document structure
  3. 03Tailors the goal to supplied arguments
  4. 04Preserves runtime, role, and model context
  5. 05Records paths and resume-critical details

Use cases

  1. 01Prepare a fresh agent to continue a conversation
  2. 02Pass context and next steps between sessions
  3. 03Resume a complete run using its ledger and result paths

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/borkweb/skills --skill handoff

After installing, type/handoffin Claude Code to confirm it loaded.

Details

From the project README

Write a handoff document summarising the current conversation so a fresh agent can continue the work. Create a unique temporary directory with the platform's secure temp helper (for Node, fs.mkdtempSync(path.join(os.tmpdir(), "handoff-"))) and write handoff.md inside it. Report the absolute path.

If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.

Preserve the actual receiving runtime and resolved role/model configuration under Key context. Do not inject orchestration defaults into an unrelated continuation. Writing a handoff does not launch a worker or change the active model. When continuing a complete run, include its ledger and per-slice result paths under Pointers, and preserve authorization, frozen gates, unresolved rulings, and agent IDs needed to resume. The receiving Codex must verify agent liveness; an ID from a previous session is not proof that a worker is still running.

Document structure

The handoff is read by another agent, so its shape is fixed. Produce exactly these eight sections, in this order, with these headings verbatim. Lead with intent and next steps, not narrative history — a fresh agent should scan top to bottom and start working.

  1. # Handoff: <short title> — one line naming the work.
  2. ## Goal — what the next session is trying to accomplish, in 1–2 sentences. If args were passed, this reflects them.
  3. ## Current state — what's done and working right now. Bullets, past tense.
  4. ## Next steps — the concrete actions to take next, ordered, each an imperative ("Wire up X", "Run Y"). The most important section: make it actionable from a cold start.
  5. ## Open questions / blockers — unresolved decisions, things waiting on someone, known risks.
  6. ## Key context — the non-obvious things: decisions made and why, gotchas, dead ends already ruled out. Skip anything a fresh agent could read straight from the code or the linked artifacts.
  7. ## Pointers — paths and URLs to the artifacts that hold the detail: PRDs, plans, ADRs, issues, branches, key files (path:line). Reference them; don't copy their contents in.
  8. ## Suggested skills — which skills the next session should use, if any, and for what.

Rules

  • Don't duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead — that's what Pointers is for.
  • If a section has no real content, write None. under it rather than padding with filler or inventing items to fill space. An empty Open questions is fine; a fabricated one is not.
  • Keep it tight. A handoff is a launchpad, not a transcript.

Comments

Markdown supported