handoff

Create structured Markdown session handoff documents with decisions and next steps.

103|21|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/robertguss/claude-code-toolkit --skill handoff-robertguss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/robertguss/claude-code-toolkit/tree/main/skills/handoff
Command: npx skills add https://github.com/robertguss/claude-code-toolkit --skill handoff-robertguss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps maintain continuity across Claude sessions by automatically generating structured handoff documents. It captures decisions, progress, code changes, and user-provided context so a future session can resume without re-explaining.

Core Features & Use Cases

  • Structured Handoff Template: Produces a consistent document with sections for Current State, What We Did, Decisions Made, Code Changes, Open Questions, Context to Remember, and Next Steps.
  • Context Preservation: Ensures future work starts with the right background and constraints.
  • Use Case Scenarios: Ending a session, taking a break, switching projects, or preparing for a known reset.

Quick Start

Use the handoff skill to generate a new handoff document and save it to .claude/handoffs/[YYYY-MM-DD]-[brief-description].md. The document can then be opened and used to resume work in the next session.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I preserve context and decisions when ending a Claude session?

To preserve context when ending a Claude session, generate a structured handoff document that captures decisions, progress, and code changes. This creates a Markdown file with sections like Current State, What We Did, and Next Steps for easy continuity.

What is the best way to maintain session continuity when switching projects?

The best way to maintain session continuity when switching projects is to write a structured Markdown handoff file. This file documents open questions, code changes, and context to remember, allowing the next session to resume work without re-explaining.

How do I create a structured handoff document for project breaks?

Create a structured handoff document for project breaks by triggering the handoff process. It automatically writes a Markdown file to .claude/handoffs/ with the current date and description, detailing what you did, decisions made, and next steps.

Does session handoff documentation require any external dependencies?

Session handoff documentation does not require external dependencies. It operates independently to generate a Markdown file containing structured sections for current state, code changes, context to remember, and next steps to ensure workflow continuity.

What information is included in a Markdown session handoff file?

A Markdown session handoff file includes structured sections for Current State, What We Did, Decisions Made, Code Changes, Open Questions, Context to Remember, and Next Steps. This ensures future work starts with the correct background and constraints.