# Handoff

> Write a handoff of the current work so a fresh session (after /clear) can pick it up. Use when the user asks to hand off, wrap up for a new session, or save the session state before /clear.

- Skill: `4miers/handoff` (Agent Skill)
- Install (CLI): `npx get-skill add 4miers/handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/4miers/handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 4mierS (https://skillmd.com/u/4miers)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/4miers/handoff

---


Write a handoff for a fresh Claude session that has no memory of this conversation.

Write it to a file with the Write tool, so it does not fill the chat. Path, in the project root:

`.claude/relay/handoffs/<YYYYmmdd-HHMMSS>-<slug>.md`

Use the current local time for the timestamp and two to four lowercase words from your title, joined by hyphens, for the slug. Start the file with this frontmatter (relay fills in `session` and `pid` itself when your turn ends):

```
---
session:
pid:
branch: <current git branch, empty outside a repository>
head: <git rev-parse --short HEAD, empty outside a repository>
previous:
---
```

Below it, use this structure, in Markdown without code fences, under 6000 characters:

# <one-line title>
## Goal
## Current state (what is done, and how it was verified)
## Next steps (ordered, concrete)
## Key files (paths and why they matter)
## Decisions and constraints (including approaches tried and rejected, and why)
## Open questions

Use exact paths, commands, names and IDs. Do not narrate the session.

Do not print the handoff in your reply. Keep the reply to one short line, in the user's language, naming the file and saying that `/clear` continues in a fresh session, where `/relay:resume` picks the handoff up.

If writing the file is refused or fails, print the handoff in your reply instead, between a line containing only `<relay-handoff>` and a line containing only `</relay-handoff>`; relay then saves it for you.

If there is no follow-up work, say so in one line and write nothing.

