# Craft Handoff

> Create a handoff document. Preserves state across sessions.

- Skill: `attac-t/craft-handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add attac-t/craft-handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/attac-t/craft-handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: attac-t (https://skillmd.com/u/attac-t)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/attac-t/craft-handoff

---


# Skill: Craft Handoff

> "A handoff is a gift to your future self."

## When

Create a handoff when:
- Ending a session
- Task is complete
- Blocked and switching focus
- Delegating to a sub-agent

## The Standard

1. **Location**: `handoffs/NNN-topic.md` in branch memory.
2. **Sequence**: Increment NNN from last handoff.
3. **Content**: What was done, decisions, next steps, learnings.
4. **Brevity**: One page max. Future you needs signal, not noise.

## The Protocol

1. **Determine trigger**: Why are we creating this handoff?
2. **Summarize done**: What was accomplished this session?
3. **List decisions**: What choices were made and why?
4. **Define next**: What should the next session do first?
5. **Extract learnings**: What patterns or insights emerged?
6. **Save**: Write to `handoffs/NNN-topic.md`.

## The Anti-Patterns

| Don't             | Do                    | Why                           |
|-------------------|-----------------------|-------------------------------|
| Dump full context | Summarize key points  | Brevity is clarity            |
| Skip decisions    | Record with rationale | Decisions are cheap to forget |
| Omit blockers     | State what's stuck    | Prevents wasted cycles        |
| Forget learnings  | Capture insights      | Compound knowledge            |

## Template

See `templates/handoff.md`.

## Loading

Handoffs are loaded automatically on session resume. Your future self will see it.