handofflisted
Install: claude install-skill jasonm4130/claude-skills
# Handoff
Write a structured resume document that lets the next Claude session
understand exactly where this session left off — without needing any of this
conversation's context.
Accept an optional free-form `<focus>` argument. If provided, use it as the
slug (lowercased, spaces replaced with hyphens). If omitted, slug = `auto`.
## Output location
```
$PROJECT_ROOT/.claude/handoffs/<ISO-timestamp>-<slug>.md
```
For example:
- `/handoff auth-token-bug` → `.claude/handoffs/2026-05-25T14-32-00-auth-token-bug.md`
- `/handoff` → `.claude/handoffs/2026-05-25T14-32-00-auto.md`
Create the `.claude/handoffs/` directory if it doesn't exist. It should be
gitignored — add `/.claude/handoffs/` to `.gitignore` if not already present.
## Required sections
Write these sections in order. Keep each section tight.
### Current state
1-2 sentences. Where are we right now? What's working, what's half-done?
### What we tried (MOST IMPORTANT)
Bullet list of failed/abandoned approaches and why each failed. This is the
highest-value section — the next session must not re-attempt the same dead
ends. If nothing failed, write "Nothing failed — clean path to current state."
### Key decisions
Each decision on its own line: **Decision** — *why*. No orphan decisions
without a reason.
### Modified files
Table or list: file path + one-line note on what changed and why. Be concrete
(`src/auth/token.ts` — added 24h expiry check, not "changed auth file").
### Blockers
Anything that is genuinely bloc