Skills Guide

Session Handoff

VerifiedSafe

Hand off the current Claude session to a fresh instance while preserving work context. Use it when the conversation context is full, after completing a logical chunk of work, or to get a fresh perspective. Work continues seamlessly from the hook.

Sby Skills Guide Bot
ProductivityIntermediate
406/2/2026
Claude Code
#handoff#session-management#context-preservation#workflow-continuity

Recommended for

Claude CodeProduct managerBeginnerSolo / indie hackerProductivity

Our review

Hands off the current Claude session to a fresh instance while preserving work context via a special mail system.

Strengths

  • Preserves hook and beads state (issues, dependencies, progress)
  • Enables session continuity without losing progress
  • Automatically collects context with the -c flag
  • Allows manual messages for handoff notes

Limitations

  • Requires Gas Town toolkit (gt commands)
  • Only works within Gas Town environment
  • In-memory state (TodoWrite, uncommitted analysis) is reset
When to use it

Use when context is filling up or after completing a logical work chunk to start fresh without losing progress.

When not to use it

Do not use when you want to keep conversation history or when you are in the middle of an atomic task that requires full context.

Security analysis

Safe
Quality score85/100

The skill only executes the 'gt handoff' tool with safe flags (-m or -c) to facilitate session cycling. It does not involve any destructive commands, external network calls, or exfiltration. The allowed tools are limited to Bash(gt handoff:*) and Bash(gt mail send:*), which are internal agent utilities.

No concerns found

Examples

Simple handoff
/handoff
Handoff with context notes
/handoff "Found the bug in token refresh - check line 145 in auth.go first"

name: handoff description: > Hand off to a fresh Claude session. Use when context is full, you've finished a logical chunk of work, or need a fresh perspective. Work continues from hook. allowed-tools: "Bash(gt handoff:),Bash(gt mail send:)" version: "1.0.0" author: "Gas Town"

Handoff - Session Cycling for Gas Town Agents

Hand off your current session to a fresh Claude instance while preserving work context.

When to Use

  • Context getting full (approaching token limit)
  • Finished a logical chunk of work
  • Need a fresh perspective on a problem
  • Human requests session cycling

Usage

/handoff [optional message]

How It Works

  1. State is collected (your message, or auto-collected inbox/beads/hook status)
  2. Handoff mail is sent to yourself with context
  3. gt handoff respawns your session with a fresh Claude
  4. New session auto-primes via SessionStart hook
  5. Work continues from your hook (pinned molecule persists)

Examples

# Simple handoff - auto-collects state (inbox, ready beads, hooked work)
/handoff

# Handoff with context notes
/handoff "Found the bug in token refresh - check line 145 in auth.go first"

What Persists

  • Hooked molecule: Your work assignment stays on your hook
  • Beads state: All issues, dependencies, progress
  • Git state: Commits, branches, staged changes

What Resets

  • Conversation context: Fresh Claude instance
  • TodoWrite items: Ephemeral, session-scoped
  • In-memory state: Any uncommitted analysis

Implementation

When invoked, execute:

  1. If user provided a message:

    gt handoff -m "<message>"

  2. If NO message provided, use -c to auto-collect state:

    gt handoff -c

IMPORTANT: Never run bare gt handoff - it sends no mail and the next session loses context. Always use -c or -m.

Related skills

Task Prioritizer

Productivity

Prioritizes your tasks using Eisenhower, ICE, and RICE frameworks.

claudechatgptbeginner
241
67
615
Admin

Weekly Status Report Generator

Productivity

Generate structured and concise weekly status reports.

Claude CodeCursorWindsurf+1beginner
234
78
635
Admin

Daily Standup Report

Productivity

Generates structured and concise daily standup reports.

claudeCursorWindsurfbeginner
178
45
483
Admin