skills.rest
trevor-vaughan
trevor-vaughanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

handoff

Captures session context into .claude/handoff/state.md for future Claude sessions.

Updated Apr 7, 2026
Search Tags:#documentation#verification#claude#handoff#session-state#git-context#portable-resume
One-click install
npx skills add https://github.com/trevor-vaughan/claude-skill-handoff --skill handoff-trevor-vaughan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/trevor-vaughan/claude-skill-handoff/tree/main/.claude/skills/handoff
Command: npx skills add https://github.com/trevor-vaughan/claude-skill-handoff --skill handoff-trevor-vaughan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The handoff slash command stops work cleanly by capturing mission-critical context, decisions, blockers, and next steps so another Claude session can pick up without missing a beat.

Core Features & Use Cases

  • Comprehensive State Capture: Synthesizes conversation mission, plan progress, decisions, blockers, key files, git status, and environment snapshots before ending a session.
  • Verification Workflow: Performs self-review, dry-run via a fresh subagent, and patching to ensure the briefing is accurate and actionable.
  • Use Case: When migrating from a container to a local machine mid-task, run /handoff to produce the .claude/handoff/state.md file that the next session reads to resume.

Quick Start

Run the /handoff slash command to generate the briefing file and hand off control to a fresh Claude session.

Frequently Asked Questions about handoff

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

FAQPage Schema
How do I save Claude session state before ending a task?▼

Capture Claude session state by running the /handoff slash command to synthesize conversation mission, plan progress, decisions, blockers, git status, and environment details into a portable briefing file for resuming work later.

What is session state documentation for AI coding assistants?▼

Session state documentation records actionable context like decisions, blockers, and progress so another AI session can resume work. It synthesizes conversation mission, git state, and environment details to prevent lost progress when migrating or ending sessions.

How do I hand off unfinished coding work to a colleague or new session?▼

Hand off unfinished work by generating a state briefing that includes mission context, plan progress, git status, and environment details. The /handoff command verifies completeness through self-review and a dry-run subagent before finalizing the transfer.

Can I migrate an ongoing AI coding task from a container to a local machine?▼

Yes, you can migrate tasks between environments by running the /handoff command to document conversation mission, plan progress, git state, and environment details into a portable state file that the next local session reads to resume.

Does the handoff command verify the accuracy of captured session context?▼

Yes, the handoff command verifies session context accuracy through self-review and a dry-run subagent test. This workflow ensures the generated briefing file is complete, accurate, and actionable before finalizing the handoff.

What limitations exist when resuming AI sessions from a state file?▼

Resuming AI sessions from a state file depends on the completeness of captured context like git status and environment details. If critical decisions or blockers remain undocumented, the next session may lack necessary context to proceed accurately.

Related Skills

Explore More Software Engineering Skills→
Omar-ObandoOmar-Obando
44

compaction-recovery

Persist mission state and checkpoints across LLM context compaction events.

Community
Advanced
leodieguesleodiegues

handoff

Compact an in-progress agent conversation into a resume-ready handoff document.

Community
Basic
yocxy2yocxy2

codex

Review code diffs and identify bugs and security vulnerabilities.

Community
Advanced
the-inconvenience-storethe-inconvenience-store
1

session-handoff

Create a session handoff document with git status and branch information.

Community
Advanced