How do I trigger a handoff?

You can use the 'ho' command for auto-detection, 'ho [message]' to add context notes, or '/conductor-finish' to complete a track and archive learnings.

Is this compatible with the Maestro framework?

Yes, it is specifically designed to work with Maestro, integrating with Conductor planning and Beads tracking for AI-assisted development.

What does the Handoff skill do?

It allows you to save your current progress and context in a Claude Code session and resume it in a fresh session to avoid token limit issues or 'context full' errors.

What data is preserved during a handoff?

Handoff persists your Beads state, Git state, specific handoff markdown files, and Agent Mail messages, while resetting the in-memory conversation context.

Session Handoff & Continuity

Name: Session Handoff & Continuity
Author: ReinaMacCredy

byReinaMacCredy

•

Productivity & Workflow

Optimizes Claude Code sessions by persisting task context and state across transitions to bypass token limits.

Handoff is a workflow optimization skill designed for Claude Code that enables seamless session cycling while preserving critical project context. By integrating with the Maestro framework, it tracks task progress through Beads, persists Git states, and generates detailed handoff logs, allowing developers to restart fresh sessions without losing momentum. This skill is essential for managing long-running development tasks where the AI's context window might otherwise become saturated, ensuring a clean slate while maintaining logical continuity.

Key Features

01Detailed handoff logging with Markdown and Agent Mail support

02Automatic session state persistence and restoration

03Intelligent auto-detection for creating or resuming work tracks

0422 GitHub stars

05Integration with Maestro Beads for granular task tracking

06Context preservation for Git state and project-specific notes

Use Cases

01Archiving completed work tracks with automated learning extraction and documentation

02Managing complex development tasks that exceed the AI's context window limits

03Transitioning between different logical phases of a project while maintaining state

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