# Handoff

Write or update a handoff document so the next agent with fresh context can continue...

- Repository: https://github.com/ykdojo/claude-code-tips (10298 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-09-25
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ykdojo/claude-code-tips --skill handoff -g -a claude-code -y`
Codex: `npx skills add ykdojo/claude-code-tips --skill handoff -g -a codex -y`
Cursor: `npx skills add ykdojo/claude-code-tips --skill handoff -g -a cursor -y`
Gemini CLI: `npx skills add ykdojo/claude-code-tips --skill handoff -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ykdojo/claude-code-tips`

## Description

Write or update a handoff document so the next agent with fresh context can continue this work.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Write or update a handoff document so the next agent with fresh context can continue this work.

Steps:
1. Check if HANDOFF.md already exists in the project
2. If it exists, read it first to understand prior context before updating
3. Create or update the document with:
   - **Goal**: What we're trying to accomplish
   - **Current Progress**: What's been done so far
   - **What Worked**: Approaches that succeeded
   - **What Didn't Work**: Approaches that failed (so they're not repeated)
   - **Next Steps**: Clear action items for continuing

Save as HANDOFF.md in the project root and tell the user the file path so they can start a fresh conversation with just that path.