When your conversation context gets bloated or you need to pause work, this generates structured handoff documents that let a fresh Claude session pick up exactly where you left off. It scaffolds the document automatically with git state and file changes, validates for completeness and accidentally leaked secrets, and checks staleness before you resume so you know if the codebase has drifted. The workflow is intentionally formal with checklists and validation scripts because ambiguous handoffs are worse than no handoffs. Best for long running projects where you're hitting context limits or switching between work sessions and need zero information loss. The handoff chaining feature for multi-part work is clever.

skills.sh installs
251
GitHub stars
33.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add davila7/claude-code-templates --skill session-handoff --agent claude-code

Installs into .claude/skills of the current project.

Files

Handoff

Creates comprehensive handoff documents that enable fresh AI agents to seamlessly continue work with zero ambiguity. Solves the long-running agent context exhaustion problem.

Mode Selection

Determine which mode applies:

Creating a handoff? User wants to save current state, pause work, or context is getting full.

  • Follow: CREATE Workflow below

Resuming from a handoff? User wants to continue previous work, load context, or mentions an existing handoff.

  • Follow: RESUME Workflow below

Proactive suggestion? After substantial work (5+ file edits, complex debugging, major decisions), suggest:

"We've made significant progress. Consider creating a handoff document to preserve this context for future sessions. Say 'create handoff' when ready."

CREATE Workflow

Step 1: Generate Scaffold

Run the smart scaffold script to create a pre-filled handoff document:

python scripts/create_handoff.py [task-slug]

Example: python scripts/create_handoff.py implementing-user-auth

For continuation handoffs (linking to previous work):

python scripts/create_handoff.py "auth-part-2" --continues-from 2024-01-15-auth.md

Sponsors

Details

Repository
github.com/davila7/claude-code-templates
Categories
Code Review & Quality, AI & Agent Building, Debugging
First seen
Jun 3, 2026

More from davila7/claude-code-templates

All 618
1pedronauck avatarexecuting-planspedronauck/skillsUse when you have a written implementation plan to execute in a separate session with review checkpoints251skills.sh installs
2tech-leads-club avatarexcalidraw-studiotech-leads-club/agent-skillsGenerate Excalidraw diagrams from natural language descriptions. Outputs .excalidraw JSON files openable in Excalidraw. Use when asked to "create a diagram", "m251skills.sh installs
3josiahsiegel avatartailwindcss-advanced-componentsjosiahsiegel/claude-plugin-marketplaceTailwind CSS advanced component patterns with CVA (class-variance-authority) and variant management. PROACTIVELY activate for: (1) building reusable component v250skills.sh installs
4maxnorm avatarmagento-php-specialistmaxnorm/magento2-agent-skillsAdvanced PHP development for Magento 2 following PSR-12 and Magento coding standards. Use when writing PHP code, implementing business logic, or ensuring code q249skills.sh installs
5nucliweb avatarwebperf-resourcesnucliweb/webperf-snippetsIntelligent network quality analysis with adaptive loading strategies. Detects connection type (2g/3g/4g), bandwidth, RTT, and save-data mode, then automaticall249skills.sh installs
6lobehub avatardb-migrationslobehub/lobehubUse for database rollout strategy, Drizzle migrations, online index creation, data backfills, migration regeneration, sequence conflicts after rebase, idempoten248skills.sh installs