SKILL DETAIL
claude-handoff
mattpocock/skills/claude-handoff
The claude-handoff skill enables you to hand off the current conversation to a fresh background agent that immediately picks up the work. It works by writing a handoff summary of the current conversation and launching a background agent seeded with that summary as its prompt. The agent starts in the current working directory and returns immediately, allowing the user to manage it with `claude agents`. When using this skill, always pass a descriptive name (e.g., `--name "Fix login bug"`) to set the display name shown in the job list, session picker, and terminal title. Include a "suggested skills" section in the summary to indicate which skills the next agent should call. Avoid duplicating 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 passes arguments, treat them as a description of what the next session will focus on and tailor the summary accordingly.
Installation
npx skills add https://github.com/mattpocock/skills --skill claude-handoff
Skill-Dateien
SKILL.md
Zuletzt synchronisiert · 22.10.2026
agents/openai.yaml›
interface:
display_name: "Claude Handoff"
short_description: "Hand off to a background agent"
policy:
allow_implicit_invocation: false
SKILL.md›
---
name: claude-handoff
description: Hand the current conversation off to a fresh background agent that picks up the work immediately.
argument-hint: "What will the next session be used for?"
disable-model-invocation: true
---
Write a handoff summary of the current conversation so a fresh agent can continue the work. Save it to the temporary directory of the user's OS, then launch a background agent seeded with it as its prompt: `claude --bg --name "<descriptive name>" -- "$(cat <summary file>)"`. Passing the file keeps the shell from running backticks or expanding `$` in the 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.