# Create Handoff

> Save session state for later resumption. Use when: - User says "done for today", "ending session", "save state" - Context is getting full (80%+) - User is taking a break - Before context compaction - User mentions "handoff", "pause work", "wrapping up"

- Skill: `majiayu000/create-handoff-10` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/create-handoff-10`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/create-handoff-10/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/create-handoff-10

---


# Create Session Handoff

Save current session state for seamless resumption.

## Usage

```bash
bash ~/.claude/scripts/handoff.sh create
```

Or use the native command:
```
/create-handoff
```

## What Gets Saved

The handoff file includes:
- **Current task**: What you're working on
- **Progress**: What's been completed
- **Decisions made**: Key choices and rationale
- **Files modified**: List of changed files
- **Next steps**: What remains to be done
- **Context**: Important information to remember
- **Learnings**: Patterns discovered in session

## Handoff Location

```
~/.claude/handoffs/
├── project-name-2024-01-15-1430.md
├── project-name-2024-01-14-0900.md
└── ...
```

## When to Create Handoff

1. **End of work session** - Before closing Claude Code
2. **Context at 80%+** - Before auto-compaction
3. **Taking a break** - Preserve state for later
4. **Switching tasks** - Save before context switch
5. **Before compacting** - Auto-triggered by PreCompact hook

## Auto-Handoff

The setup automatically creates handoffs:
- Before context compaction (PreCompact hook)
- At session end (SessionEnd hook)

## Output

Confirms:
- Handoff file created
- Location of file
- Key information saved

## Resume Later

To resume from a handoff:
```
/resume-handoff
```

This loads the most recent handoff for the current project.