About handoff
handoff is a skill for creating a concise continuation document so a fresh agent can resume current work. It emphasizes avoiding duplication by pointing to existing artifacts and recommends skills for the next session.
Key features
- 01Summarizes conversation state
- 02Captures next-session goal and open decisions
- 03References existing artifacts instead of duplicating them
- 04Suggests skills for the next session
- 05Writes to a temporary Markdown path
Use cases
- 01Transferring ongoing work to a fresh agent
- 02Recording blockers and decisions before ending a session
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ alirezarezvani/ claude-skills --skill handoffAfter installing, type/handoffin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/companion_tooling.mddeduplication_discipline.mdhandoff_structure.mdnext_session_skill_matching.mdscripts/artifact_deduplicator.pyhandoff_template_generator.pyskill_recommender.pyDetails
From the project READMEHandoff
Derived from Matt Pocock's handoff (MIT). Matt's no-duplication discipline preserved verbatim. Additions: tools + references + cs-* wrapper (see references/companion_tooling.md).
Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by mktemp -t handoff-XXXXXX.md (read the file before you write to it).
Suggest the skills to be used, if any, by the next session.
Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
Sections
- Goal of next session (from user argument or inferred)
- State of play (what's done, what's blocking)
- Open decisions (what the next agent must decide)
- Skills to use (concrete list)
- Artifacts (paths/URLs to PRDs, plans, ADRs, issues, branches, PRs — do not duplicate)
Tooling
See references/companion_tooling.md. Tools: template + dedup + recommender. Agent: cs-handoff-author. Command: /cs-handoff.
Version: 1.0.0 Derived: Matt Pocock (MIT) + this repo's wrapper