handoff

Convert the current agent conversation into a structured markdown handoff document.

Updated May 11, 2026
One-click install
npx skills add https://github.com/IsKenKenYa/Commory --skill handoff-iskenkenya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/IsKenKenYa/Commory/tree/main/.windsurf/skills/handoff
Command: npx skills add https://github.com/IsKenKenYa/Commory --skill handoff-iskenkenya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of losing valuable conversation context when switching from one agent to another, ensuring the next agent can pick up with minimal repetition and maximum continuity.

Core Features & Use Cases

  • Conversation-to-handoff summarization: Condenses the current discussion into a handoff document with the essential goals, decisions, and open items.
  • Next-session tailoring via arguments: If you provide an argument, it is treated as a description of what the next session should focus on, shaping the handoff accordingly.
  • Artifact-aware de-duplication: Avoids duplicating content already captured in PRDs, plans, ADRs, or issues by referencing them by path or URL instead.
  • Operational instruction to save output: Produces a handoff saved to a temporary file path generated via mktemp, so the content can be read before writing.

Quick Start

Ask the agent to create a handoff document and include what the next session will be used for, so a fresh agent can continue the same work without repeating prior artifacts.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I transfer conversation context to another agent without losing prior decisions?

To transfer conversation context, you need a structured handoff document that summarizes goals, decisions, and open items. This approach condenses the current discussion into a markdown file, ensuring the next agent session maintains maximum continuity with minimal repetition.

What is the best way to summarize a multi-agent workflow for a follow-on session?

The best way to summarize a multi-agent workflow is to generate a conversation summary tailored to the next session's focus. By providing a description of the upcoming work as an argument, the handoff document is shaped to address specific follow-on tasks and context persistence.

How do I create a handover document that does not duplicate existing plans and ADRs?

To create a handover document without duplicating existing artifacts, reference PRDs, plans, ADRs, or issues by their path or URL instead of repeating their content. This artifact-aware de-duplication ensures the handoff remains concise and directs the next agent to original sources.

Can I tailor the agent handoff output for a specific task context?

Yes, you can tailor the agent handoff output by providing an argument describing what the next session should focus on. This argument is treated as a description of the upcoming work, shaping the generated handoff document to align with the specific task context.

Where does the generated handoff markdown file get saved?

The generated handoff markdown file is saved to a temporary file path created via the mktemp command. This operational instruction ensures the content is written to a secure temporary location where it can be read and reviewed before finalizing.

When do I need a context transfer document for agent collaboration?

You need a context transfer document for agent collaboration when switching from one agent to another in a multi-agent workflow. It is required for task handovers and follow-on work where conversation context must persist across separate agent sessions to prevent losing valuable decisions.