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.

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

01Seamlessly transitions work to fresh sessions to optimize token usage

02Maintains a structured directory of handoff logs and individual session snapshots

03Integrates Agent Mail for persistent asynchronous messaging between sessions

04Automatically detects and resumes recent handoffs within a 7-day window

05Persists Beads issue tracking and Git state across session restarts

0620 GitHub stars

Use Cases

01Transitioning between logical chunks of work to maintain a clean workspace

02Refreshing Claude's memory when the context window becomes full or sluggish

03Saving a detailed snapshot of current progress before pausing a long-term development project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add reinamaccredy/maestro handoff

For use in Claude.ai and ChatGPT

Download Skill