← ClaudeAtlas

handofflisted

Snapshot session state to .claude/handoff_current.md and tell the user (loudly, with -*-*- borders) to start a new session. Requires the scripts/hooks installed by this repo's ./install.sh — not a prompt-only skill. Use at clean boundaries (commit lands, track wraps), when the user signals context pressure ("getting long", "meter is full"), or whenever the user invokes /handoff. Blocks until the user actually starts a new session — do not start new work after invoking.
Sting25/claude-code-handoff · ★ 5 · AI & Automation · score 70
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