claude-handoff

Launches a background agent seeded with a summary of the current conversation.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/j172/bid --skill claude-handoff-j172
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-handoff
Source: https://github.com/j172/bid/tree/main/.agents/skills/claude-handoff
Command: npx skills add https://github.com/j172/bid --skill claude-handoff-j172

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long conversations accumulate context that becomes hard to carry forward. This Skill writes a handoff summary of the current conversation and immediately launches a fresh background agent seeded with that summary, so work continues without losing momentum or manually copying context. ## Core Features & Use Cases - Conversation Summarization: Generates a handoff summary that references existing artifacts (PRDs, plans, ADRs, commits) by path instead of duplicating them. - Background Agent Launch: Runs claude --bg --name "<descriptive name>" with the summary as the prompt, returning immediately while the agent works in the current directory. - Sensitive Data Redaction: Strips API keys, passwords, and personally identifiable information before the summary becomes the agent's prompt. - Use Case: After a long debugging session, hand off the remaining work to a named background agent like "Fix login bug" and monitor it with claude agents. ## Quick Start Ask the assistant to hand off the current conversation to a background agent focused on your next task, optionally describing what the next session should accomplish.

Frequently Asked Questions about claude-handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I hand off a Claude conversation to a background agent?

Invoke the handoff skill, which writes a summary of the current conversation and launches it with `claude --bg --name "<name>" "<summary>"`. The agent starts in the current working directory and returns immediately.

How do I manage background agents after a handoff?

Use the `claude agents` command to view and manage running background agents. The descriptive name passed with `--name` appears in the job list, session picker, and terminal title.

Does the handoff summary include sensitive information?

No. The skill redacts API keys, passwords, and personally identifiable information before the summary becomes the agent's prompt, since the summary text is passed directly to the new agent.

Can I specify what the next session should focus on?

Yes. Pass arguments describing the next session's purpose, and the skill tailors the handoff summary accordingly. The argument hint is "What will the next session be used for?"

Does the handoff duplicate existing plans or documents?

No. The summary references existing artifacts such as PRDs, plans, ADRs, issues, commits, and diffs by path or URL instead of duplicating their content.