Write a handover document
Writes a handover for leave or a role change covering responsibilities, open work status, contacts, access, recurring tasks, known risks and first-week priorities, with gaps listed as questions.
A handover is read by someone covering work they did not build, often in a hurry, on the day something goes wrong. It fails when it is a diary of history instead of a guide to action, when "status" means "in progress" with no next step, when access and passwords are an afterthought, and when the knowledge that lives only in the leaver's head (the client who needs a call not an email, the report that breaks every quarter-end) never gets written down. A good handover is organised by what the reader must do, says who decides what, and is honest about what is unfinished.
Turn these notes into a handover document. Only if [HANDOVER_DATE] is given: Handover date:
- If the notes do not say what the role is or list any current work, ask for them and stop.
- Sort everything in the notes into the sections below. Do not drop anything; if an item fits nowhere, put it under "Other notes".
- For each open piece of work, state: what it is, current status in one line, the very next action, the owner from the handover date, the deadline, and where the files or tickets live. If any of these are missing, write
[ASK: …]in that cell. - Separate decisions the cover person can make alone from ones that need someone else, and name that person or role.
- Build a calendar of recurring tasks (daily, weekly, monthly, quarterly) with the date of the next occurrence if the handover date allows it.
- Pull out the tacit knowledge: workarounds, quirks, sensitive relationships and "if X happens, do Y" rules, and write each as a short instruction.
- Write the first-week priorities: the three to five things the cover person must do or check first.
- Never put passwords, keys, tokens or personal data in the document. Say where access is managed (password manager, IT ticket, admin) and who grants it; if the notes contain a secret, leave it out and warn about it in Questions before you go.
- Use only facts from the notes. Do not invent names, dates, systems or statuses.
- Keep it scannable: tables for open work, contacts and recurring tasks; short bullets elsewhere. Write for someone who has never seen this work.
- Be neutral and factual about colleagues and clients; describe working preferences, not personalities.
Handover
Summary: role, handover period, cover person or [ASK], and how to reach the leaver if at all (or "do not contact").
First-week priorities: numbered.
Open work: table: Work | Status | Next action | Owner | Deadline | Where it lives.
Responsibilities: bullets, marking which are delegated, paused or covered by whom.
Decisions: two lists: "You can decide" and "Escalate to …".
Recurring tasks: table: Task | Frequency | Next due | How | Where.
Contacts: table: Name or role | What for | Notes on working with them.
Access and tools: table: System | What it is used for | How to get access.
Known risks and quirks: bullets with "if this happens, do this".
Other notes
Questions before you go
Every [ASK: …] gathered into one list for the leaver to answer, plus any warning about secrets found in the notes.
Handover meeting agenda
A 30 to 45 minute agenda for walking the cover person through it.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Writing and communication
- category
- Business writing
- level
- Beginner
- made for
- Anyone, personal use, People manager, Operations, Project / program manager
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-handover-document --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-handover-document -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-writing-communication@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Business writingWrite a project status report
Writes a project status report with an evidence-based RAG status, progress, risks, decisions needed and next steps, formatted as an email, a document or a single slide.
write-status-reportWrite a professional email
Drafts an email from rough intent with a specific subject line, the ask in the first two sentences and the right tone for the relationship, marking any detail it would otherwise have to invent.
write-professional-emailWrite an executive summary
Writes an executive summary of a long document that leads with the bottom line, the key points and the ask, using only facts from the source. Use before sending a report to busy readers.
write-executive-summaryWrite an internal announcement
Writes an internal announcement of a reorg, policy change or launch that explains what is changing, why, the impact on each group and where to ask, plus an FAQ and a pre-send check.
write-internal-announcementWrite a project proposal or business case
Writes an internal project proposal or business case covering the problem, options, recommendation, cost, benefits and risks, and marks every missing number instead of inventing it.
write-project-proposalReport writing track
Takes a work report from purpose and audience to an answer-first outline, an evidence check, a full draft, an executive summary and a final edit, pausing for approval between steps.
report-writing-track