claude-handoff

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

10|3|Updated Jul 18, 2019
One-click install
npx skills add https://github.com/tanqimin/MyFavsORM --skill claude-handoff-tanqimin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-handoff
Source: https://github.com/tanqimin/MyFavsORM/tree/main/.agents/skills/claude-handoff
Command: npx skills add https://github.com/tanqimin/MyFavsORM --skill claude-handoff-tanqimin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a conversation grows long or a task needs to continue in a fresh session, context is lost. This Skill writes a concise handoff summary of the current conversation and immediately launches a background agent seeded with that summary, so work continues without manual copy-pasting. ## Core Features & Use Cases - Automatic Handoff Summary: Generates a summary of the current conversation, referencing existing artifacts (specs, plans, ADRs, commits) by path instead of duplicating them. - Background Agent Launch: Runs claude --bg --name "<descriptive name>" "<summary>" so the new agent starts in the current working directory and returns immediately, manageable via claude agents. - Safety and Focus: Redacts sensitive information (API keys, passwords, PII), suggests which skills the next agent should invoke, and tailors the summary to user-provided arguments about the next session's focus. - Use Case: You have been debugging a login issue and want a fresh agent to implement the fix. Invoke this Skill with a note like "implement the login fix", and a named background agent picks up the work with full context. ## Quick Start Ask the assistant to hand off the current conversation to a background agent named for the next task, optionally describing what the next session should focus on.

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 new agent?

Invoke the claude-handoff Skill, optionally describing what the next session will focus on. It writes a handoff summary and launches a background agent with `claude --bg --name "<name>" "<summary>"`, which starts in the current working directory immediately.

How do I manage background agents after a handoff?

Background agents launched by the handoff are managed with the `claude agents` command. The descriptive name passed via `--name` appears in the job list, session picker, and terminal title so you can identify each agent.

Does the handoff summary include sensitive information?

No. The Skill explicitly redacts sensitive information such as API keys, passwords, and personally identifiable information before the summary becomes the new agent's prompt.

What does the handoff summary contain?

It contains a concise summary of the conversation, references to existing artifacts (specs, plans, ADRs, issues, commits, diffs) by path or URL rather than duplicated content, and a suggested skills section naming skills the next agent should call.

When should I not use conversation handoff?

Avoid it when the task is nearly complete and a fresh agent would add overhead, or when context is fully captured in committed artifacts that a new session can read directly. It is best for substantial ongoing work needing fresh context.