handofflisted
Install: claude install-skill SpoiledMilkLabs/skills
# Handoff
Capture session state for cold-start resume. Three modes: **create** (default), **resume**, **list**.
## What this skill does NOT do
**It does not relieve in-session context pressure.** The conversation transcript is already in the prompt cache when `/handoff create` runs. Writing the handoff is a *write*-side op for the **next** session. After Create completes, the skill tells you to `/clear` (or close the session) — continuing in the same conversation will still hit compact and the handoff buys you nothing until you start fresh.
## Configuration
The skill reads `~/.claude/handoffs/config.json` on every invocation. If the file doesn't exist, use these defaults and write the file on first run so the user can edit it:
```json
{
"retention": "archive",
"max_versions": 10,
"history_path": "sessions/.history/",
"auto_obsidian_log": true,
"update_check": {
"enabled": true,
"repo": "SpoiledMilkLabs/skills",
"throttle_days": 7
}
}
```
- `retention`: `"archive"` (default) keeps a single archived copy of an orphaned handoff. `"version-history"` keeps the last `max_versions` of each handoff under `history_path`. See **Retention modes** below.
- `max_versions`: cap for `version-history` mode. Older versions get pruned.
- `history_path`: relative to `~/.claude/handoffs/`. Folder structure: `<history_path>/<slug>/vN.md`.
- `auto_obsidian_log`: append archive events to `~/knowledge/wiki/log.md` if the vault exists. Off = silent archival.
- `update_c