handoff · ykdojo — Claude Code skill: what it does, how to install
Creates or updates a HANDOFF.md file so an agent in a fresh session can pick up the task with full context.
npx skills add ykdojo/claude-code-tips --skill handoff -a claude-codeWhat handoff does
The skill inspects the repository root for an existing HANDOFF.md. If present, the agent reads prior notes before rewriting them. It documents five core areas: project goals, current status, methods that worked, failed attempts, and concrete next actions.
Everything is saved directly to HANDOFF.md at the project root. The agent prints the file path, letting you launch a new session pointing straight to that file. Without logging failed attempts, fresh agents inevitably repeat dead-end experiments.
What it helps with
- preserve task progress before resetting context
- record failed approaches to prevent repeated mistakes
- outline next action items for an incoming agent
- hand over unfinished work to another session
Example prompts for the agent
- Create a
HANDOFF.mdfile summarizing our progress and next steps. - Update
HANDOFF.mdwith what worked and what failed so far. - Run handoff so I can start a fresh agent session.
How to install handoff
1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill handoff -a claude-code2Manually: put the files in place
~/.claude/skills/handoff/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/handoff/
1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill handoff -a codex2Manually: put the files in place
.agents/skills/handoff/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill handoff -a cursor2Manually: put the files in place
.cursor/skills/handoff/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ykdojo/claude-code-tips handoff2Manually: put the files in place
.github/skills/handoff/SKILL.md1Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill handoff -a gemini-cli2Platform CLI
gemini skills install https://github.com/ykdojo/claude-code-tips --path skills/handoffManually: put the files in place
.devin/skills/handoff/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ykdojo/claude-code-tips --skill handoff -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about handoff
How to install handoff in Claude Code?
Run npx skills add ykdojo/claude-code-tips --skill handoff -a claude-code in your terminal. You can also save it directly to ~/.claude/skills/handoff/SKILL.md.
What does the handoff skill do?
It inspects or creates HANDOFF.md in the project root to capture goals, completed work, successful and failed attempts, and upcoming tasks.
Why does handoff record failed attempts?
Logging what did not work stops the next agent with blank memory from retrying broken solutions.
Similar skills
All skills for Agent setup: memory, context, orchestration →handoff by other authors comes first.