Handoff

Compact the current conversation into a handoff document for another agent to pick up.

hmailserver 2ab87e8 1.1 KB Updated

File contents

Condense this conversation into a handoff note that lets a fresh agent resume the work without re-reading the transcript.

Write the file into the OS temp directory, never into the workspace.

What to write:

  • The task, why it's being done, and where it currently stands.
  • Decisions already made and options already ruled out, so the next agent doesn't reopen them.
  • What remains: the next concrete step, plus anything blocked or waiting on the user.
  • Gotchas discovered along the way — failing commands, environment quirks, dead ends.
  • A "Suggested skills" section listing the skills the next agent should invoke via the Skill tool.

What to leave out:

  • Anything already written down elsewhere: specs, plans, ADRs, issues, commit messages, diffs. Link or cite the path instead of copying the content.
  • Secrets and personal data. Strip API keys, passwords, tokens, and PII.

If arguments were passed, they describe the next session's focus — weight the document toward that and trim detail that isn't relevant to it.

hmailserver/hmailserver/tree/main/.claude/skills/handoff commit 2ab87e8ea7

Frequently asked questions

npx skillmds@latest add hmailserver/handoff