Handoff

Creates a handoff document that summarizes the current conversation for another agent to continue work, referencing existing artifacts by path or URL rather than duplicating them. Use when transferring a conversation to a fresh agent or starting a new session that builds on prior work.

skills.sh installs: 443
GitHub stars: 29.5K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add alirezarezvani/claude-skills --skill handoff --agent claude-code

Installs into .claude/skills of the current project.

Files

Handoff

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)