hermes

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.

context

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.

task

Write an announcement for about this change:

change

Only if [TONE] is given: Tone: .

  1. If the input does not say what is changing or when, ask for that and stop.
  2. 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.
  3. Explain why, using the actual reason from the input. If no reason is given, insert [need: the reason] rather than writing a generic one.
  4. Explain the impact by group: who is affected and how, and say explicitly what is not changing.
  5. List what readers need to do, with deadlines. If nothing, say "No action needed".
  6. Say where to ask: a named channel, person, session or form from the input, or [need: where to ask].
  7. 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.
  8. 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]").
constraints
  • 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.
output format

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
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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-internal-announcement --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-internal-announcement -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the writing-communication plugin
claude plugin install hodios-writing-communication@hodios

The plugin brings every entry in this domain at once.

PromptBusiness writing

Write 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-report
PromptPublic speaking

Prepare 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-questions
PromptEditing

Rewrite 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-tone
PromptBusiness writing

Write 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-summary
PromptBusiness writing

Write 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-proposal
WorkflowBusiness writing

Report 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