mcpField
H
handoff

handoff

github.com/steveclarkeAgent workflows36102 installsUpdated 1d ago
Repository

About handoff

handoff is a skill for briefing the session that continues a task, aimed at developers handing off ongoing work. It focuses on completed work, remaining tasks, decisions, and practical context, while keeping the brief out of the repository.

Key features

  1. 01Summarize completed and remaining work
  2. 02Record decisions and established patterns
  3. 03Collect repository and environment context
  4. 04Deliver the brief to a later session
  5. 05Keep briefs out of the repository

Use cases

  1. 01Hand off progress at the end of a work session
  2. 02Help a later session resume unfinished tasks
  3. 03Share branch, environment, and key file details

Install

Copy the command and run it in a terminal.

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

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

Details

From the project README

Handoff — Brief the Next Session

Pass the state of this session to the session that continues the work. A handoff is a briefing, not a record: it is delivered straight to the next session wherever possible, and it is never committed to the repo.

1. Gather State

Collect only what the next session needs:

Done:

  • Tasks or phases completed
  • Files created or modified (high level)
  • Commits made and pushed (branch, remote status)

Not done:

  • Remaining tasks or phases
  • Bugs hit and fixed, so the next session doesn't repeat them
  • Anything partially started

Decisions:

  • Choices the user approved that constrain future work
  • Patterns established
  • Approaches tried that didn't work

Practical details:

  • Repo path, branch, remote
  • Dev environment state (running, or how to start it)
  • Test credentials if relevant
  • Key file paths (specs, plans, docs) — 2-4 at most

If the next task isn't obvious, ask: "What should the next session focus on?"

2. Write the Brief

Keep it under a minute to read. Self-contained — no "see above".

# [Topic] — Handoff (YYYY-MM-DD)

[1-2 sentence summary of where things stand]

## Done
- ...

## Not Done
- ...

## Decisions
- ...

## Bugs Fixed (Don't Repeat)
- ...

## Practical
- Repo: [path] (branch: [branch])
- Dev stack: [state]

## Next
[What to do first]

## Read First
- [path] — [why]

3. Deliver It

Use the first route that works:

  1. Another Claude Code session is running. Find it with ListAgents and send the brief with SendMessage. Confirm which session it is before sending.
  2. The target runs in Herdr or tmux. Send the brief to the target pane with the herdr skill (inside Herdr) or the tmux-orchestration skill (plain tmux). Confirm the pane before sending.
  3. No live target. Write the brief to ${TMPDIR:-/tmp}/handoff-YYYY-MM-DD-<topic>.md, copy a one-line resume prompt that points at it to the clipboard (pbcopy on macOS, wl-copy or xclip -selection clipboard on Linux), and give the user the path. The file is disposable; losing it on reboot is fine.

Never write the brief into the project or commit it.

What NOT to Include

  • Conversation play-by-play
  • Raw error logs (summarize the fix)
  • File contents or implementation details readable from disk
  • Anything derivable from git log or the code

Comments

Markdown supported