handoff
by Matt Pocock · mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
What it tells an agent to do.
The author’s own instructions, as your agent receives them — the same bytes the endpoint serves.
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 - 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.
More in agents & skills
dispatching-parallel-agents
Jesse Vincent
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
What it does →subagent-driven-development
Jesse Vincent
Use when executing implementation plans with independent tasks in the current session
What it does →writing-skills
Jesse Vincent
Use when creating new skills, editing existing skills, or verifying skills work before deployment
What it does →context-engineering
Addy Osmani
Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching between tasks, or when you need to configure …
What it does →claude-handoff
Matt Pocock
Hand the current conversation off to a fresh background agent that picks up the work immediately.
What it does →writing-for-agents
Matt Pocock
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
What it does →