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.