Write 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.
People read a change announcement asking four questions in order: what is changing, does it affect me, why, and what do I do now. Announcements fail when the change is buried under a preamble about values, when the reason is vague or spun ("to unlock synergies"), when they cheer about news that is bad for some readers, or when nobody knows where to ask. For changes that affect people's jobs, managers, roles or pay, the order of communication matters as much as the words: the people most affected should hear it directly, before a broadcast.
Write an announcement for about this change:
Only if [TONE] is given: Tone: .
- If the input does not say what is changing or when, ask for that and stop.
- Open with a subject line or headline that states the change itself, and a first paragraph that says what is changing and when it takes effect.
- Explain why, using the actual reason from the input. If no reason is given, insert
[need: the reason]rather than writing a generic one. - Explain the impact by group: who is affected and how, and say explicitly what is not changing.
- List what readers need to do, with deadlines. If nothing, say "No action needed".
- Say where to ask: a named channel, person, session or form from the input, or
[need: where to ask]. - Match the tone to the news. A launch can be upbeat. A reorg, a cut or a policy that removes a benefit is plain and respectful: acknowledge that it is a real change for some people, without corporate euphemism and without over-apologising.
- Draft an FAQ of five to eight questions readers will actually ask, including the uncomfortable ones (Is this a cost cut? Will there be more changes? What happens to my role?). Answer only from the input; where the answer is unknown, write the honest holding answer ("We don't know yet; we will tell you by [date]").
- Never invent reasons, numbers, dates, names or commitments.
- No euphemisms that hide what is happening ("rightsizing", "transitioning roles"). Say "roles will be eliminated" if that is the fact.
- Do not mention any individual's performance, health or personal circumstances.
- Keep the announcement under 350 words; detail goes in the FAQ.
- If the change involves job losses, pay or contract changes, or anything with legal implications, add to Before you send that HR or legal should review it, and that affected people must be told directly first.
Announcement
Subject line, then the message with short sections: What is changing · Why · What it means for you · What you need to do · Questions.
FAQ
Numbered questions with short answers.
Before you send
A checklist: who must hear before this goes out, any [need: …] placeholders, reviews required, and the best channel and timing.
2 required values still a placeholder; the assistant will ask for them.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Writing and communication
- category
- Business writing
- level
- Intermediate
- depth
- Specific
- made for
- People manager, Executive / leader, Operations, Founder / business owner
- risk
- read-only
- version
- v1.0.0 · experimental
- 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-internal-announcement --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-internal-announcement -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-reportPrepare for tough questions
Anticipates the hardest questions a talk, pitch or meeting will draw from a given audience, drafts short honest answers to rehearse, and names the weak spots to fix beforehand.
prepare-for-tough-questionsRewrite a text for tone
Rewrites a text in a target tone or register, such as warmer, firmer or more formal, without changing its facts, asks or commitments, and shows which tone dials moved.
rewrite-for-toneWrite a work document
Drafts a memo, report, proposal, update or announcement from your notes, picking the right type for the reader and leading with the point and the ask. Use when you need to write something at work.
write-work-documentWrite an award nomination
Writes an award or recognition nomination that maps a colleague's specific achievements and evidence to each published criterion, within the word limit, and shows where the case is weak.
write-award-nominationWrite a formal letter
Writes a formal letter to a bank, council, school, supplier or official body in the layout and conventions of the chosen country, with a clear purpose, references and a specific request.
write-formal-letter