claude-handoff
by Matt Pocock · mattpocock/skills
Hand the current conversation off to a fresh background agent that picks up the work immediately.
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 summary of the current conversation so a fresh agent can continue the work. Instead of saving it, launch a background agent seeded with the summary as its prompt: claude --bg --name "<descriptive name>" "<handoff summary>". It starts in the current working directory and returns immediately; the user manages it with claude agents.
Always pass -n/--name with a descriptive name (e.g. --name "Fix login bug"); it sets the display name shown in the job list, session picker, and terminal title.
Include a "suggested skills" section in the summary, 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, since the summary becomes the agent's prompt.
If the user passed arguments, treat them as a description of what the next session will focus on and tailor the summary 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 →handoff
Matt Pocock
Compact the current conversation into a handoff document for another agent to pick up.
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 →