# Conversation Handoff

Compact the current conversation into a document for another agent.

- Repository: https://github.com/mattpocock/skills (309182 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mattpocock/skills --skill handoff -g -a claude-code -y`
Codex: `npx skills add mattpocock/skills --skill handoff -g -a codex -y`
Cursor: `npx skills add mattpocock/skills --skill handoff -g -a cursor -y`
Gemini CLI: `npx skills add mattpocock/skills --skill handoff -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add mattpocock/skills`

## Description

Compact the current conversation into a handoff document for another agent to pick up.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS (`$TMPDIR`, else `/tmp`; `%TEMP%` on Windows) - not the current workspace.

Include a "suggested skills" section in the document, naming which skills the next agent should call the Skill tool for.

Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.

Redact any sensitive information, such as API keys, passwords, or personally identifiable information.

If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.