handoff

Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it DURABLY — never only to the OS temporary directory, which Windows Storage Sense deletes (a prior handoff was lost from %TEMP%\agent-handoffs that way):

• Preferred: write it as a basic-memory note with write_note under compaction-checkpoints/, tagged handoff and compaction-checkpoint (see ~/.agents/memory-contract.md).
• If basic-memory is unreachable: write it to ~/.claude/sessions/YYYY-MM-DD-<short-id>-session.tmp (the save-session convention), then capture it into basic-memory once the daemon is reachable again.
• Either way, do not save it only inside the current workspace, and never only in %TEMP%.

Include a "suggested skills" section in the document, which suggests skills that the agent should invoke.

Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.

Redact any sensitive information, such as API keys, passwords, or personally identifiable information.

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

---

Vendored from https://github.com/mattpocock/skills — MIT License, Copyright (c) 2026 Matt Pocock. Absorbed into agent-skills-toolchain 2026-06-11; full MIT notice in LICENSE (this folder).

Local change 2026-10-31 (agent-skills-toolchain): the save-location instruction above was changed from "the OS temporary directory" to durable storage (basic-memory compaction-checkpoints/, else ~/.claude/sessions/), because Windows Storage Sense wipes %TEMP% and destroyed a prior agent-handoffs handoff. Local behavioural change only; the upstream skill is otherwise unmodified.