handoff

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

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/mikalv/pi-extensions --skill handoff-mikalv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/mikalv/pi-extensions/tree/main/packages/pi-atelier/.agents/skills/handoff
Command: npx skills add https://github.com/mikalv/pi-extensions --skill handoff-mikalv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a conversation grows long or needs to move to a new session, context is lost and the next agent starts blind. This Skill compacts the current conversation into a portable handoff document so a fresh agent can continue the work without re-reading the entire history. ## Core Features & Use Cases - Conversation Compaction: Summarizes the current session into a structured handoff document saved to the OS temporary directory, keeping the workspace clean. - Suggested Skills Section: Recommends which skills the next agent should invoke to continue the work effectively. - Artifact Referencing & Redaction: References existing specs, plans, ADRs, issues, commits, and diffs by path or URL instead of duplicating them, and strips sensitive data such as API keys, passwords, and PII. - Use Case: You finish a long debugging session and want a new agent to implement the fix. Run the handoff with a note like "implement the retry logic we diagnosed" and the next session receives a focused, sanitized summary. ## Quick Start Ask the agent to create a handoff document 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 transfer conversation context to a new agent session?▼

Invoke the handoff skill to compact the current conversation into a summary document saved in your OS temporary directory. A fresh agent can read that document and continue the work without the full history.

How do I focus a handoff document on a specific next task?▼

Pass an argument describing what the next session will be used for. The skill treats your input as the next session's focus and tailors the handoff document accordingly.

Does the handoff document duplicate existing specs or plans?▼

No. The skill references existing artifacts such as specs, plans, ADRs, issues, commits, and diffs by path or URL instead of copying their content into the handoff document.

Is sensitive data like API keys included in the handoff?▼

No. The skill explicitly redacts sensitive information, including API keys, passwords, and personally identifiable information, before writing the handoff document.

Where is the handoff document saved?▼

The document is saved to the temporary directory of your operating system, not the current workspace, so it does not clutter your project files.