handofflisted
Install: claude install-skill Sting25/claude-code-handoff
# /handoff — write a session handoff
> **Prerequisite:** this skill drives scripts and hooks from
> https://github.com/Sting25/claude-code-handoff: `write_handoff.sh`
> under `~/.claude/bin/` and the Stop / SessionStart / SessionEnd hooks
> in the project's `.claude/settings.json` (or `.claude/settings.local.json`
> with `--local`, or `~/.claude/settings.json`)
> are NOT part of this file. Run
> `./install.sh --scope project --project <dir>` from that repo before
> first use.
Used at clean boundaries (after a commit, when a major track wraps),
when the user signals context pressure, or whenever the user invokes
`/handoff`. Hands the next session a complete state snapshot so
nothing gets lost across the restart boundary.
## What this skill does
1. **Snapshot state**: runs `write_handoff.sh` (resolved from
`~/.claude/bin/`, see Steps below), which captures:
- HEAD, branch, recent commits, working-tree state for the current repo
- Same for an optional sibling "substrate" repo (configured via
`HANDOFF_SUBSTRATE_NAME`, e.g. a shared decisions / RFCs repo)
- In-flight (untracked or modified) `.md` docs under the configured
directories (default: `docs/`; configurable via `HANDOFF_INFLIGHT_DIRS`)
- The "verify state matches reality" command block
- Before overwriting `handoff_current.md`, the script rotates the
previous one into `.claude/handoff_history/` and prunes to the
last `HANDOFF_HISTORY_KEEP` (default 5). The next session's
Sessi