What data is lost during a session handoff?

The conversational history, ephemeral TodoWrite items, and uncommitted in-memory analysis are reset to provide Claude with a fresh perspective.

How do I pass instructions to the next Claude session?

You can provide an optional message with the /handoff command, which is automatically sent as a handoff mail to the new session.

Will I lose my code changes when using handoff?

No. Your Git state, including all commits, branches, and staged changes, is fully preserved across sessions.

Does my progress in Gas Town persist?

Yes, all 'beads' state (issues, dependencies, progress) and your 'hooked molecule' remain active and available to the new session.

When is the best time to use the /handoff command?

Use it when your context window is getting full, when you have finished a logical chunk of work, or if the model starts to lose focus.

Session Handoff & State Management

Name: Session Handoff & State Management
Author: steveyegge

bysteveyegge

•

2,077

•

Productivity & Workflow

Refreshes Claude sessions while preserving critical workspace context and project state for continuous development.

The Handoff skill enables Gas Town agents to cycle their current session into a fresh Claude instance, effectively clearing saturated conversation context without losing progress. It is particularly useful for managing long-running tasks that approach token limits or when a fresh perspective is required for complex debugging. By persisting hooked work assignments, issue tracking states, and Git changes, it ensures a seamless transition where the new session can immediately resume from the previous agent's stopping point.

Key Features

012,077 GitHub stars

02Retention of Git state including commits and staged changes

03Seamless integration with the Gas Town multi-agent workspace

04Context window clearing via automated session respawning

05Persistence of hooked work assignments and 'pinned molecules'

06Automated handoff messaging via internal mail system

Use Cases

01Managing long-running development tasks that exceed Claude's token limit

02Transferring progress between agents within a multi-agent workflow

03Resetting conversational history to improve reasoning on specific bugs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add steveyegge/gastown handoff

For use in Claude.ai and ChatGPT

Download Skill