handoff

Write a handoff document summarizing the current conversation for a fresh agent session.

Updated Nov 23, 2024
One-click install
npx skills add https://github.com/tokisakiyuu/dotfiles --skill handoff-tokisakiyuu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/tokisakiyuu/dotfiles/tree/main/home/dot_claude/skills/handoff
Command: npx skills add https://github.com/tokisakiyuu/dotfiles --skill handoff-tokisakiyuu

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 handoff document so a fresh agent can pick up the work without re-reading the entire history. ## Core Features & Use Cases - Conversation Compaction: Summarizes the current conversation into a standalone handoff document saved to a temporary file created with mktemp. - Artifact Referencing: Avoids duplicating content already captured in PRDs, plans, ADRs, issues, commits, or diffs by referencing them via path or URL. - 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: You have been debugging a deployment issue for hours and the context window is nearly full. Run the handoff skill to produce a summary document, then start a fresh session that reads it and continues the investigation. ## Quick Start Ask the agent to create a handoff document for the next session, optionally describing what that 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 transfer context between AI agent sessions?▼

Run the handoff skill to summarize the current conversation into a document saved at a temporary path. The next session reads that document and continues the work without needing the full prior conversation history.

What should a handoff document include for the next agent?▼

It should summarize the current conversation, reference existing artifacts like PRDs, plans, ADRs, issues, commits, and diffs by path or URL, and suggest which skills the next session should use.

Where is the handoff document saved?▼

The document is saved to a path generated by mktemp with the handoff prefix, producing a unique temporary markdown file. The file is read before writing to ensure the path is valid.

Can I customize the handoff for a specific next task?▼

Yes. Pass arguments describing what the next session will focus on, and the skill treats them as the next session's purpose and tailors the document accordingly.

Does the handoff duplicate content from existing project documents?▼

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