How to Hand Off Claude Code Conversations with claude-handoff
機械翻訳 / Machine-translated
Original article: How to Hand Off Claude Code Conversations with claude-handoff (cccskills)
Skill page: claude-handoff
Summary of this article
/claude-handoff command handles everything, eliminating the need to manually write a summary and paste it into a new sessionclaude --bg is unavailable, or those whose work wraps up in short conversationsInstalling claude-handoff lets you summarize your current Claude Code conversation and hand off the continuation to a new background agent.
It's a skill designed for people working through long tasks — the handoff target launches in the same working directory.
Here we explain what happens when you invoke it, how to focus the handoff on a specific next goal, and how to install it along with things to watch out for.
When you invoke claude-handoff, your current conversation is turned into a handoff summary.
The new agent receives that summary as its initial instructions and starts running in the background.
Since the handoff target launches from the current working directory, it can pick up right where you left off in the same repository or folder.
/claude-handoff Focus the next session on fixing the login bug
When you send this request, the agent first summarizes the conversation so far and saves it as a file in the OS's temporary directory.
It then launches a background agent with claude --bg and passes the contents of the summary file as the initial instructions.
Because the launch command returns immediately, your current conversation is never kept waiting.
The new agent is given a descriptive name like "Fix login bug."
That name appears in the job list, the session selection screen, and the terminal title.
Launched agents are managed collectively with claude agents.
With claude-handoff, everything from summarizing the conversation to launching the next agent is handled in a single invocation.
There's no need to manually write a summary and paste it into a new session.
The four main functions are as follows.
It condenses a long conversation into a form that lets a new agent pick up where things left off.
The summary is passed to the launch command via a file.
This means that even if the summary contains backticks or $ characters, the shell won't execute or expand them.
Adding an argument when invoking the skill treats it as the goal for the next session.
If you include something like "fix the login bug," the summary is written to match that task.
This is useful when you already know what comes next and want to avoid carrying over unnecessary context.
Content found in specs, plans, ADRs (Architecture Decision Records), issues, commits, and diffs is not copied into the summary.
Instead, it's referenced by path or URL, so the same information never appears twice.
The summary also includes a "suggested skills" section listing the skills the next agent should invoke.
The summary becomes the instructions for the next agent directly.
For this reason, API keys, passwords, and personally identifiable information are always omitted from the summary.
There are two ways to install: running a single command, or asking an agent to do it.
To install via command, run the following one line.
You can choose the target — Claude Code, Codex, etc. — at the time you run it.
npx skills add https://github.com/mattpocock/skills --skill claude-handoff
To have an agent install it, send the following message as-is.
The procedure has you review the contents first before placing the files.
次の Agent Skill をインストールしてください。
https://github.com/mattpocock/skills/tree/main/skills/in-progress/claude-handoff
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/claude-handoff/、Codex なら ~/.agents/skills/claude-handoff/ に配置してください。
If you're placing the files manually, refer to the table below for the correct locations.
| Target | All projects (global) | Per project |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ in your project |
| Codex | ~/.agents/skills/ | .agents/skills/ in your project |
The distribution source is mattpocock/skills on GitHub, with 320,478 stars.
claude-handoff is located in the in-progress folder of that repository.
Since the skill is configured not to be called automatically by agents, specify it by name as /claude-handoff when you want to use it.
The basic usage is to invoke /claude-handoff at a natural stopping point in your work.
If you already know your next goal, include it as an argument.
/claude-handoff
Calling it without arguments creates a summary of the current conversation.
The new agent receives that summary as its instructions and launches in the background from the same working directory.
/claude-handoff Hand off so the next session can focus exclusively on fixing the login screen bug
Adding a goal focuses the summary on that task.
The handoff target is given a descriptive name, so you won't have trouble distinguishing it from other agents in the job list.
/claude-handoff Continue implementing according to the plan in docs/plan.md
If you have a plan saved in a file, the summary references it by path rather than copying its contents.
The new agent uses the summary and the plan file as its guide and picks up the work from the same location.
As a prerequisite, you need a Claude Code environment where you can launch background agents with claude --bg.
The claude command is used to start the handoff target.
Even when placing the skill in Codex, an environment where this command works is essential.
Before handing off, it's recommended to write out any finalized specs or plans to files or issues.
That way, the summary can reference them by path or URL.
Note that the summary itself is saved to the OS's temporary directory.
Instructions to omit sensitive information are built into the skill.
Even so, if your conversation involved API keys or passwords, it's a good idea to explicitly add "do not include sensitive information in the summary" when invoking the skill.
The license is MIT.
Before installing, read SKILL.md and confirm there is no external data transmission or credential reading.
The same mattpocock/skills repository contains skills that pair well when working through long tasks in stages.
chief-of-staff is a skill for coordinating the work of multiple sub-agents toward a long-term goal.
It maintains an ongoing dialogue with the user while also improving the working environment and conventions.
It's suited for situations where you want to manage the entire workflow at a larger scale than handing off one session at a time.
ask-matt recommends relevant skills for your situation and suggests the order in which to use them.
It's the skill to consult when you're unsure which skills to have the next agent use.
The launch command returns immediately, so you can continue the original conversation as normal.
The new agent runs in the background and is managed via claude agents.
Check via claude agents.
The name assigned at launch appears in the job list, the session selection screen, and the terminal title.
You can distinguish between agents even when multiple are running.
Placing the skill in the Codex location is possible.
However, since the handoff target is launched using claude --bg, an environment where the Claude Code command works is required.
The skill includes instructions to omit API keys, passwords, and personally identifiable information.
That said, the summary becomes the instructions for the next agent.
For conversations that involved sensitive information, it's safer to explicitly ask the skill to exclude it when invoking it.
claude-handoff is a skill that summarizes a lengthy Claude Code conversation and hands off the continuation to a new background agent.
The handoff target launches in the same working directory with a clear, descriptive name.
Adding your next goal focuses the summary accordingly, and specs and plans are referenced by path or URL.
If you want to work through long tasks in manageable stages, give it a try from the cccskills page.
This article is a reprint of the cccskills article "How to Hand Off Claude Code Conversations with claude-handoff."
Full skill details and installation instructions can be found on the cccskills claude-handoff page.