handoff

Generates a conversation handoff document for a fresh agent to continue work.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/gmackie/agent-skills --skill handoff-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/gmackie/agent-skills/tree/main/skills/handoff
Command: npx skills add https://github.com/gmackie/agent-skills --skill handoff-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a conversation grows long or a session ends, context is lost and the next agent or session must start from scratch. 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: Summarizes the current conversation into a handoff document saved to the OS temporary directory, keeping the workspace clean. - Suggested Skills Section: Recommends skills the next agent should invoke to continue the work effectively. - Artifact Referencing and Redaction: References existing specs, plans, ADRs, issues, commits, and diffs by path or URL instead of duplicating them, and redacts sensitive data such as API keys, passwords, and PII. - Use Case: Before ending a long debugging session, invoke the handoff skill with a note like "next session: finish the migration tests" so the next agent receives a tailored summary with pointers to relevant commits and plans. ## 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 another AI agent?▼

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

How to preserve context when starting a new AI coding session?▼

Create a handoff document before ending the session. It captures the essential state of the work, references specs, plans, and commits by path, and suggests skills the next agent should invoke.

Where is the handoff document saved?▼

The document is saved to the temporary directory of the user's operating system, not the current workspace. This keeps the project repository free of transient session files.

Does the handoff document include API keys or secrets?▼

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

Can I customize the handoff for what the next session will do?▼

Yes. Pass arguments describing the next session's focus, and the skill treats them as guidance to tailor the document's content and emphasis accordingly.