handoff

Create or update HANDOFF.md with goals, progress, decisions, and session links.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tylern91/dotfiles --skill handoff-tylern91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/tylern91/dotfiles/tree/main/claude/.claude/skills/handoff
Command: npx skills add https://github.com/tylern91/dotfiles --skill handoff-tylern91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Handoff helps ensure seamless continuation of work by transferring context to a fresh agent when the current session ends or the context becomes too long.

Core Features & Use Cases

  • Create or update a HANDOFF.md in the project root to document goals, progress, decisions, and next steps.
  • Read any existing HANDOFF.md to preserve prior context and append new information, including session history when available.
  • Enrich the handoff with recent session history from ~/.claude/sessions and provide clear action items for the next agent.
  • Use to coordinate work across agents, ensuring continuity in long-running projects.

Quick Start

Create or update HANDOFF.md in the project root and save a session summary using context-manager save to ensure both persistence paths are updated.

Frequently Asked Questions about handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve context when switching to a new AI agent?

To preserve context when switching to a new AI agent, create or update a HANDOFF.md document in your project root. This file captures goals, progress, decisions, and next steps to ensure seamless continuation.

What is the best way to manage project context across long AI agent sessions?

Managing project context across long AI agent sessions involves documenting goals and progress in a HANDOFF.md file. The system reads existing files and enriches them with recent session history to support continuity.

How do I transfer session history to a fresh agent?

You can transfer session history to a fresh agent by reading existing HANDOFF.md files and appending new information. The process enriches the handoff document using recent session history from the ~/.claude/sessions directory.

Does the handoff process work across different project roots?

Yes, the handoff process operates across project roots to incorporate recent session history. It reads existing HANDOFF.md files when present and guides successor agents through goals, progress, and decisions.

What should I include in project documentation for AI agent continuity?

Project documentation for AI agent continuity should include goals, progress, decisions, next steps, and session links. The HANDOFF.md file preserves this prior context and provides clear action items for the next agent.

Why does my AI agent lose context when the session gets too long?

AI agents lose context when sessions become too long because of context window limitations. Creating a HANDOFF.md document transfers the essential context to a fresh agent, ensuring seamless continuation of long-running projects.