Handoff — Development

Compacts the current conversation into a handoff document for another agent to pick up, referencing existing artifacts by path or URL instead of duplicating content. It produces a markdown file with sections for goal, state, decisions, skills, and artifacts.

engineering claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Generates a handoff document with sections: Goal, State of play, Open decisions, Skills to use, Artifacts.
References existing artifacts (PRDs, plans, ADRs, issues, commits, diffs) by path or URL.
Suggests skills for the next session.
Tailors the document to the user-provided description of the next session's focus.
Saves the document to a temporary file path created by mktemp.

🎯 When to use it

When you want to hand off the conversation to a fresh agent.
When starting a new session that needs to pick up prior work.
When you need a concise summary of the current state without duplicating existing docs.

🚀 How to use

Trigger: /cs:handoff

Trigger by asking to hand off the conversation or start a new session picking up prior work. Optionally provide a description of what the next session will focus on. The skill will create a handoff document and save it to a temp file. Example prompts:

Hand off this conversation to a new agent.
Create a handoff document for a session that will implement the API changes.

📄 Output: A markdown handoff document saved to a temporary file.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering/handoff/skills/handoff .claude/skills/handoff

Skill source: engineering/handoff/skills/handoff/SKILL.md

⚠️ Good to know

Requires that existing artifacts are accessible by path or URL; the skill does not create new content beyond the handoff summary.

❓ FAQ

What does the handoff document contain?

It contains sections for the goal of the next session, state of play, open decisions, skills to use, and references to existing artifacts.

How does the skill avoid duplicating content?

It references existing artifacts by path or URL instead of duplicating their content.

Can I specify what the next session should focus on?

Yes, you can pass arguments describing the next session's focus, and the document will be tailored accordingly.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.