About handoff
handoff is an agent skill that creates or updates a project’s HANDOFF.md so an agent starting with fresh context can continue the work. It records progress, successful and failed approaches, and next steps.
Key features
- 01Checks for an existing HANDOFF.md
- 02Reads prior context before updating
- 03Records goal, progress, and approaches
- 04Lists actionable next steps
- 05Saves the document in the project root
Use cases
- 01Preparing work for a fresh agent session
- 02Recording approaches that should not be repeated
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/handoffin Claude Code to confirm it loaded.
Details
From the project READMEWrite or update a handoff document so the next agent with fresh context can continue this work.
Steps:
- Check if HANDOFF.md already exists in the project
- If it exists, read it first to understand prior context before updating
- 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.
Comments
Markdown supported