handoff

Compact active session context and environment state into a portable Markdown document.

2|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/zachmayer/skills --skill handoff-zachmayer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/zachmayer/skills/tree/main/.claude/skills/handoff
Command: npx skills add https://github.com/zachmayer/skills --skill handoff-zachmayer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the issue of context loss when an AI session reaches its limit or needs to be restarted, ensuring that a new agent can pick up complex work exactly where the previous one left off.

Core Features & Use Cases

  • Context Compaction: Summarizes active tasks, environment state, and critical findings into a portable Markdown file.
  • State Preservation: Captures git branch status, uncommitted changes, and running processes to maintain technical continuity.
  • Use Case: When working on a long-running feature branch and the conversation context becomes cluttered or hits a token limit, use this skill to generate a handoff document that allows a fresh session to resume development immediately.

Quick Start

Use the handoff skill to summarize the current session and prepare a transition file for a new agent.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I transfer context between AI agent sessions when hitting a token limit?

To transfer context between AI agent sessions, this Skill compacts active conversation state and environment details into a portable Markdown document. This preserves technical state and pending action items, allowing a new session to resume work immediately.

How do I preserve git branch status and uncommitted changes for a new AI session?

Preserving git branch status and uncommitted changes requires capturing repository state within a handoff document. This Skill verifies repository status via shell commands and compiles uncommitted changes into a Markdown file for the next agent.

Does generating a session handoff report require shell command access?

Generating a session handoff report requires shell command access for repository status verification. It also requires file system operations to store the generated Markdown document, ensuring the technical state is accurately captured and persisted.

What is the best way to maintain workflow continuity across independent AI agents?

Maintaining workflow continuity across independent AI agents is achieved by compacting active tasks and decision logs into a portable Markdown file. This approach ensures technical state and environment data are seamlessly transferred to the new agent.

Can I use this context handoff approach for long-running feature branch development?

You can use this context handoff approach for long-running feature branch development. When your conversation becomes cluttered or reaches its token limit, it generates a transition file summarizing critical findings for a fresh session to resume.