skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
gastownhall/beads215 installs

handoff

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.

How do I install this agent skill?

npx skills add https://github.com/gastownhall/beads --skill handoff
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The 'handoff' skill is a utility designed for session management within the Gas Town agent framework. It uses vendor-specific commands to send context notes via email and restart the agent session, maintaining project state through internal mechanisms. No malicious patterns or security risks were identified.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

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. If you provide a message, it's sent as handoff mail to yourself
  2. gt handoff respawns your session with a fresh Claude
  3. New session auto-primes via SessionStart hook
  4. Work continues from your hook (pinned molecule persists)

Examples

# Simple handoff (molecule persists, fresh context)
/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, send handoff mail:

    gt mail send <your-address> -s "HANDOFF: Session cycling" -m "<message>"
    
  2. Run the handoff command:

    gt handoff
    

The new session will find your handoff mail and hooked work automatically.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/gastownhall/beads/handoff">View handoff on skillZs</a>