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 handoffIs 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
- If you provide a message, it's sent as handoff mail to yourself
gt handoffrespawns your session with a fresh Claude- New session auto-primes via SessionStart hook
- 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:
-
If user provided a message, send handoff mail:
gt mail send <your-address> -s "HANDOFF: Session cycling" -m "<message>" -
Run the handoff command:
gt handoff
The new session will find your handoff mail and hooked work automatically.
How can the creator link this skill?
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>