handoff

Summarizes the current conversation into a handoff document for a fresh agent session.

2|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/brandtam/rubber-ducky-legacy --skill handoff-brandtam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/brandtam/rubber-ducky-legacy/tree/main/.agents/skills/handoff
Command: npx skills add https://github.com/brandtam/rubber-ducky-legacy --skill handoff-brandtam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a conversation grows long or a task must continue in a new session, context is lost. This Skill compacts the current conversation into a structured handoff document so a fresh agent can pick up the work without re-reading the entire history. ## Core Features & Use Cases - Conversation Compaction: Writes a summary of the current conversation to a temporary markdown file created via mktemp. - Artifact Referencing: Avoids duplicating content already captured in PRDs, plans, ADRs, issues, commits, or diffs by referencing them by path or URL instead. - Next-Session Guidance: Suggests which skills the next session should use and tailors the document based on user-provided arguments describing the next session's focus. - Use Case: Before ending a long debugging session, run the handoff skill with a note like "next session: implement the fix" so the incoming agent knows exactly where to start. ## Quick Start Ask the agent to create a handoff document summarizing this conversation for the next session, optionally describing what the next session will focus on.

Frequently Asked Questions about handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I hand off a conversation to a new agent session?▼

Invoke the handoff skill, which writes a summary of the current conversation to a temporary markdown file. A fresh agent reads that file to continue the work without replaying the full history.

How do I pass context between Claude Code sessions?▼

Use the handoff skill to compact the conversation into a markdown document saved via mktemp. You can pass an argument describing the next session's focus so the document is tailored to upcoming work.

Does the handoff document duplicate my plans and commits?▼

No. The skill explicitly avoids duplicating content already captured in PRDs, plans, ADRs, issues, commits, or diffs. It references those artifacts by path or URL instead of copying their content.

Where is the handoff document saved?▼

The document is saved to a temporary path generated by `mktemp -t handoff-XXXXXX.md`. The file is read before writing to ensure the path is valid.

When should I not use a conversation handoff summary?▼

Avoid it when all relevant context already exists in durable artifacts like commits, issues, or ADRs, since the handoff would add no new information. It is most useful for capturing ephemeral reasoning and in-progress state.