write-a-handover-that-works

write-a-handover-that-works is a skill for Claude Code, Codex from everywan-dev/claude-code-engineering. It costs 52 tokens per session (1,781 once invoked), scanned A, original, Apache-2.0.

A structure for writing handovers that let another person or a later work session continue without guessing. A handover is a written transfer of work, including what was checked and what was not.

In plain words
What is it for?
Use it at the end of a session, day or task, or when passing work to someone else, to record the starting state, verified results and remaining checks.
Why use it?
It preserves important context that would otherwise be lost between sessions, especially when work is unfinished or evidence is missing.

Skill for Claude CodeCodex

Part of the claude-code-engineering plugin — 47 skills, 1 command, 8 agents, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/everywan-dev/claude-code-engineering/write-a-handover-that-works
Any agent
npx skills add everywan-dev/claude-code-engineering --skill write-a-handover-that-works
Clone the repo
git clone --depth 1 https://github.com/everywan-dev/claude-code-engineering

Made for: Claude Code, Codex.

Or install claude-code-engineering, the plugin that ships this one along with the rest of its 47 skills, 1 command, 8 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for write-a-handover-that-works

README.md
[![agentmods](https://agentmods.dev/badge/skills/everywan-dev/claude-code-engineering/write-a-handover-that-works.svg)](https://agentmods.dev/skills/everywan-dev/claude-code-engineering/write-a-handover-that-works)
Your own site
<a href="https://agentmods.dev/skills/everywan-dev/claude-code-engineering/write-a-handover-that-works"><img src="https://agentmods.dev/badge/skills/everywan-dev/claude-code-engineering/write-a-handover-that-works.svg" alt="Measured on agentmods" height="20"></a>
Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,781 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00052 $0.01781
Opus 5 $0.00026 $0.00890
Sonnet 5 $0.00010 $0.00356
Haiku 4.5 $0.00005 $0.00178

Measured 3d ago against content hash d7a6453d485a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

write-a-handover-that-works scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/write-a-handover-that-works/SKILL.md · 191 lines

How it starts

The opening of the file, as written. The whole thing — 191 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Write a handover that works

The next session starts blind. It gets your files and none of your head. Whatever you did not write down was not saved — it was forgotten, in a way that looks exactly like it never happened.

So the handoff has one job:

Let the next session act without re-deriving anything, and without trusting anything you did not check.

Those are two separate promises. Most handoffs keep the first and quietly break the second.

When to use this

  • A task will not finish before the session ends
  • You are stopping mid-sequence — applied, not yet verified
  • Someone else is picking this up
  • You are about to hit a context limit and the work is long

The five sections

Everything else is optional. These five are not.

1. Starting state — captured, not remembered

The output you took before you touched anything: the process list, the version in use, the row count, the routing table. Raw, pasted.

This is not for the change. It is for the argument three days later about whether the change caused the thing that broke. Without it, that argument has no winner.

2. Verified — each claim with the check and its output

One line per claim, and each line carries the command and what it printed.

- New route answers on all three nodes — `<per-node request>` → 200, body contains the new build id (pasted below)

If you cannot attach an output, the claim does not belong in this section. Move it down one.

3. NOT verified — the section everyone skips

🔴 This is the most important part of the handoff and it is the one that gets left out. It is also the only section whose absence is invisible: a handoff with no "not verified" list reads like a handoff where everything was checked.

Every claim you believe but did not observe goes here, with how to check it:

- I believe the workers reconnected after the restart — not observed.
  Check: enqueue one job and read the consumer's own log line.

An empty "not verified" section is a claim in itself, and it is almost always false. If yours is empty, you have not sorted the list yet.

Read the full file on GitHub · 191 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 191 lines · 52 tokens per session scan A d7a6453d485a

Subscribe to this mod's changes

write-a-handover-that-works is a skill published in the GitHub repository everywan-dev/claude-code-engineering (2 stars, last pushed 14d ago), licensed Apache-2.0. It adds 52 tokens to every session and 1,781 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

obsidian-cli

Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their…

breferrari/obsidian-mind · 102 tokens

pairing

Build work collaboratively in reviewable pieces, handing each piece back for review before starting the next, so the person stays in the lead and steers while the work happens instead of reviewing a finished result. Use when someone says to pair with them on something, asks to collaborate rather than direct, wants to…

testdouble/han · 189 tokens

memory-notes

How to write well-structured Basic Memory notes: frontmatter, observations with semantic categories, relations with wiki-links, and best practices for building a rich knowledge graph. Use when creating or improving notes.

basicmachines-co/basic-memory · 44 tokens

memory-onboarding

Guide someone new to Basic Memory through designing and building a complete personal knowledge system — interview them about what they want to track, propose a structure, build it with schemas and instruction notes, teach them to use it, and set up their AI assistant to load it automatically. Use this skill whenever a…

basicmachines-co/basic-memory · 148 tokens

basic-memory

Use the Basic Memory knowledge graph for persistent memory across sessions. Search before answering; capture decisions, meetings, and insights as notes.

basicmachines-co/basic-memory · 29 tokens

memory-ingest

Process unstructured external input (meeting transcripts, conversation logs, pasted documents) into structured Basic Memory entities. Extracts entities, searches for existing matches, proposes new entities with approval, creates notes with observations and relations, and captures action items.

basicmachines-co/basic-memory · 52 tokens