handoff

Generates a handoff document summarizing the current conversation for the next agent session.

Updated May 23, 2026
One-click install
npx skills add https://github.com/Oatse/CWE-Automation --skill handoff-oatse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/Oatse/CWE-Automation/tree/main/.agents/skills/handoff
Command: npx skills add https://github.com/Oatse/CWE-Automation --skill handoff-oatse

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 session into a concise handoff document saved to a temporary file path. - 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 to the user's stated focus for the follow-up session. - Use Case: You have been debugging a feature across a long session and want to continue tomorrow. Run the handoff skill with a note like "continue fixing the auth bug" to produce a document the next agent can start from. ## 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 hand off an AI agent conversation to a new session?

Invoke the handoff skill, which summarizes the current conversation into a document saved at a temporary path. A fresh agent can read that document to resume the work without the full chat history.

How to pass context between AI agent sessions?

Create a handoff document that captures the essential state of the current session and references existing artifacts by path or URL. The next session loads this document instead of replaying the entire conversation.

Does the handoff document duplicate my PRDs 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.

Can I specify what the next session should focus on?

Yes. Pass an argument describing the next session's focus, and the skill tailors the handoff document accordingly. It also suggests which skills the next session should use.

Where is the handoff document saved?

The document is saved to a unique temporary file path generated with mktemp using the handoff prefix. The file is read before writing to ensure the path is handled correctly.