What specifically gets reset during a handoff?

The active conversation history, ephemeral TodoWrite items, and any uncommitted in-memory analysis are reset to provide a fresh instance.

When is the best time to use a session handoff?

You should use it when the context window is getting full, after finishing a logical chunk of work, or if Claude seems to be losing track of the current goal.

Does the handoff skill lose my current code changes?

No, handoff preserves your Git state, including commits, branches, and staged changes, along with all Beads tracking data.

Can I provide specific instructions for the next session?

Yes, you can include an optional message with the /handoff command which will be sent as handoff mail to prime the new session.

Session Handoff

Name: Session Handoff
Author: steveyegge

bysteveyegge

•

8,427

•

생산성 및 워크플로

Resets the conversation context of a Claude session while maintaining critical task state, progress, and Git history.

The Handoff skill is a specialized utility designed to manage the context window of Claude Code sessions. When a conversation becomes too long or approaches token limits, Handoff allows the agent to spawn a fresh instance while persisting important metadata through the Beads system. It ensures that the current work assignment (pinned molecules), issue tracking, and repository state remain intact, providing a 'clean slate' for the AI's reasoning without losing the progress of the overall project. This is essential for long-running development tasks and maintaining high-quality agent performance over time.

주요 기능

01Automates session re-priming via SessionStart hooks

028,427 GitHub stars

03Maintains Git state and pinned work assignments across sessions

04Persists Beads state including issues, dependencies, and progress

05Resets conversation context to avoid token limit saturation

06Supports custom handoff messages to prime the next session

사용 사례

01Continuing complex, multi-stage coding tasks that exceed a single context window

02Passing specific status notes and task context to a fresh Claude instance

03Refreshing the agent's perspective when conversation history becomes cluttered or irrelevant

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add steveyegge/beads handoff

For use in Claude.ai and ChatGPT

Download Skill