Skip to main content
ClaudeWave
Skill8.7k repo starsupdated yesterday

handoff

The handoff skill creates or updates a HANDOFF.md document that summarizes project goals, completed work, successful and failed approaches, and next steps. Use this when transitioning work to another Claude agent or conversation session to provide essential context without requiring the new agent to review full conversation history.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/ykdojo/claude-code-tips /tmp/handoff && cp -r /tmp/handoff/skills/handoff ~/.claude/skills/handoff
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

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.