handoff

Capture git and project state into HANDOFF.md and claude-progress.txt.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Asher-Plihal/claude-skills --skill handoff-asher-plihal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/Asher-Plihal/claude-skills/tree/main/handoff
Command: npx skills add https://github.com/Asher-Plihal/claude-skills --skill handoff-asher-plihal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents lost context when switching to a fresh chat by capturing the current repo state, committing progress, and generating a single, ready-to-paste continuation prompt.

Core Features & Use Cases

  • Repo state capture: Records git status, recent commit history, diffs/stashes, and session progress cues without dumping raw output into chat.
  • Progress preservation: Detects uncommitted changes and commits in-progress work with safe, file-specific staging while updating claude-progress.txt.
  • Context handoff document: Writes a structured HANDOFF.md that becomes the authoritative source for what to resume next, including feature status from feature_list.json and worktrees from WORKTREES.md or equivalent.
  • Paste-ready next prompt: Prints a single block with branch/last commit and the exact next step to resume.

Quick Start

Trigger the skill when Asher types /handoff (or phrases like “pass to new chat” or “prepare a handoff”) to commit progress, generate HANDOFF.md, and receive a copy-paste prompt for the new chat.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I preserve uncommitted git changes when switching to a new chat session?

To preserve uncommitted git changes during a session handoff, the skill stages file-specific in-progress work, commits it safely, and updates a progress tracking file so the new chat receives full repository context without information loss.

What is the best way to create a context handoff document for resuming development?

The best way to create a context handoff document is to generate a structured HANDOFF.md that records git status, recent commits, and feature status from feature_list.json, serving as the authoritative source to resume workflow in a fresh chat.

How do I generate a continuation prompt to resume work in a different chat?

You generate a continuation prompt by capturing the current branch, last commit, and the exact next step into a single paste-ready block, allowing a fresh chat to resume active development immediately without manual context rebuilding.

Does the handoff process work with existing progress tracking files like claude-progress.txt?

Yes, the handoff process works with existing progress tracking files by updating claude-progress.txt and feature_list.json during ordered phases that capture project state, ensuring session continuity across chat switches.

Can I prepare a git repository handoff without dumping raw command output into the chat?

Yes, you can prepare a repository handoff without raw output by recording git status, commit history, and diffs internally, then writing the summarized context into HANDOFF.md and a clean continuation prompt for the new session.

When should I use an automated session handoff instead of manually explaining project state?

You should use an automated session handoff when switching chats during active development with uncommitted changes, because it prevents lost context by committing progress and generating a structured handoff document rather than relying on manual explanations.