How do I resume a previous session?

Simply use the 'ho' command or 'ho resume'. The skill includes auto-detect logic that will look for recent handoffs (within 7 days) and restore the relevant context.

What data is preserved during a session handoff?

The handoff preserves Beads state, Git state, Handoff markdown files, and Agent Mail messages, ensuring continuity in your development workflow while resetting the conversation memory.

What happens if a handoff is older than 7 days?

The auto-detect logic will flag the handoff as 'stale' and warn you, usually suggesting a fresh CREATE mode to avoid working with outdated context.

When is the best time to use the handoff skill?

You should use it when your conversation context is getting full, you have finished a logical chunk of work, or you feel the AI needs a fresh perspective on a specific problem.

Does this skill work with any Claude Code project?

Yes, while it is optimized for the Maestro workflow, it provides a standardized way to log, cycle, and resume sessions for any project being developed with Claude Code.

Session Handoff & Context Manager

Name: Session Handoff & Context Manager
Author: ReinaMacCredy

byReinaMacCredy

•

Productivity & Workflow

Manages Claude Code session transitions by preserving state, context, and progress across fresh session restarts.

About

The Handoff skill enables seamless session cycling for Claude Code, allowing developers to reset context windows without losing work progress. By integrating with the Maestro workflow, it persists critical state information like Beads (issue tracking), Git status, and Agent Mail, while clearing exhausted conversation history. This ensures that the AI stays sharp with a fresh perspective while maintaining a detailed record of tasks, enabling long-running projects to proceed without hitting token limits or losing continuity during complex development cycles.

Key Features

Seamlessly transitions work to fresh sessions to optimize token usage
Maintains a structured directory of handoff logs and individual session snapshots
Integrates Agent Mail for persistent asynchronous messaging between sessions
Automatically detects and resumes recent handoffs within a 7-day window
Persists Beads issue tracking and Git state across session restarts
20 GitHub stars

Use Cases

Transitioning between logical chunks of work to maintain a clean workspace
Refreshing Claude's memory when the context window becomes full or sluggish
Saving a detailed snapshot of current progress before pausing a long-term development project

About

Key Features

Seamlessly transitions work to fresh sessions to optimize token usage
Maintains a structured directory of handoff logs and individual session snapshots
Integrates Agent Mail for persistent asynchronous messaging between sessions
Automatically detects and resumes recent handoffs within a 7-day window
Persists Beads issue tracking and Git state across session restarts
20 GitHub stars

Use Cases

Transitioning between logical chunks of work to maintain a clean workspace
Refreshing Claude's memory when the context window becomes full or sluggish
Saving a detailed snapshot of current progress before pausing a long-term development project