Skip to content
Skills Library
Documents & office · Writing

internal-comms

/internal-comms

Write internal communications that people actually read - weekly status updates, team newsletters, FAQ answers, leadership notes, project updates and incident communications - with an audience and tone matrix and fixed structure templates. Use when the user asks to "write a status update", "draft the weekly newsletter", "write an incident update" or "send a note to leadership". In French "rédige une note interne", "écris le point hebdo de l'équipe", "annonce ce changement à l'équipe" or "prépare la communication d'incident".

Repository
navin ↗
Licence
AGPL-3.0
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What it does and when to use it

Write internal communications that people actually read - weekly status updates, team newsletters, FAQ answers, leadership notes, project updates and incident communications - with an audience and tone matrix and fixed structure templates. Use when the user asks to "write a status update", "draft the weekly newsletter", "write an incident update" or "send a note to leadership". In French "rédige une note interne", "écris le point hebdo de l'équipe", "annonce ce changement à l'équipe" or "prépare la communication d'incident".

Triggers from the description

write a status updatedraft the weekly newsletterwrite an incident updatesend a note to leadershiprédige une note interneécris le point hebdo de lannonce ce changement à lor
Original author description

Write internal communications that people actually read - weekly status updates, team newsletters, FAQ answers, leadership notes, project updates and incident communications - with an audience and tone matrix and fixed structure templates. Use when the user asks to "write a status update", "draft the weekly newsletter", "write an incident update" or "send a note to leadership". In French "rédige une note interne", "écris le point hebdo de l'équipe", "annonce ce changement à l'équipe" or "prépare la communication d'incident".

How it works

  1. Pick the format
  2. Audience and tone matrix
  3. What to ask before writing
  4. Workflow
  5. Structure templates
  6. Quality bar
  7. Bundled files
Original SKILL.md headings · 143 lines, 1,018 words
SKILL.md preview
---
name: internal-comms
description: Write internal communications that people actually read - weekly status updates, team newsletters, FAQ answers, leadership notes, project updates and incident communications - with an audience and tone matrix and fixed structure templates. Use when the user asks to "write a status update", "draft the weekly newsletter", "write an incident update" or "send a note to leadership". In French "rédige une note interne", "écris le point hebdo de l'équipe", "annonce ce changement à l'équipe" or "prépare la communication d'incident".
metadata: {"navin":{"emoji":"📣","category":"writing"}}
---

# Internal Comms

Internal communication competes with everything else in a colleague's inbox.
The reader gives it thirty seconds; the text must earn more or deliver in
thirty. Every format below optimises for that: the point first, numbers over
adjectives, links instead of retelling, and a clear statement of what the
reader should do.

This skill covers the recurring formats. For external announcements use the
marketing skills; for formal letters or long reports use `professional-writer`;
for a document that needs stakeholder co-authoring use `doc-coauthoring`.

## Pick the format

| Request sounds like | Format | Example |
|---|---|---|
| "weekly update", "what did the team do", "3P" | Status update: Progress, Plans, Problems | `examples/status-update.md` |
| "newsletter", "company digest", "monthly recap" | Newsletter with sections and links | `examples/newsletter.md` |
| "people keep asking", "FAQ", "answer these questions" | FAQ answers | `examples/faq-answers.md` |
| "we are down", "outage comms", "post the incident status" | Incident update | `examples/incident-update.md` |
| "note to leadership", "heads-up to execs" | Leadership note (structure below) | - |
| "project update", "milestone mail" | Project update (status update structure with a timeline line) | `examples/status-update.md` |

If none fits, ask for audience, purpose and tone, then use the leadership note
structure as the default.

## Audience and tone matrix

| Audience | They want | Tone | Length |
|---|---|---|---|
| Executives | decisions needed, risk, numbers against plan | matter-of-fact, no hedging | 5 to 8 lines |
| Whole company | what changed for them, where to read more | warm, first person plural ("we") | 20 to 25 bullets max |
| Own team | detail, credit, next steps | direct, informal | as long as useful |
| Neighbouring teams | dependencies, dates, who to contact | precise, neutral | 1 screen |
| Everyone during an incident | impact, workaround, next update time | calm, factual, no blame | 6 to 10 lines |

Match the vocabulary to the reader: a company newsletter never contains a
ticket number; a team update can be nothing but ticket numbers.

## What to ask before writing

Ask in one message, accept shorthand answers:

1. Audience and channel (chat post, email, wiki page) - the channel sets the
   length and whether links or attachments work.
2. Period covered (last week, the sprint, the quarter) or the moment (incident
   start time).
3. Source material: notes, tickets, dashboards, a previous update to mirror.
   Read what is given with `read_file`; search the user's notes or meetings
   with the `notes` and `meetings` tools when available; use `accounts`
   (mail.search, calendar.list) only when the user points at a mailbox or
   calendar.
4. Anything that must not be said yet (unannounced hires, pending deals,
   personal situations).
5. Who signs it, and whether there is a call to action.

If the user has already pasted the content, skip the questions and format.

## Workflow

1. Identify the format from the table and read its example file.
2. Collect facts. Every statement needs a source the user can verify: a number,
   a link, a named deliverable. Never invent a metric to make a line sound
   complete; write `[number?]` and ask.
3. Draft in the structure of the chosen format. Lead with the item that
   changes the reader's week.
4. Trim. Remove adjectives ("exciting", "huge"), remove history the reader
   already knows, merge duplicate items, turn paragraphs into one-line bullets
   where the format allows.
5. Check against the audience matrix: tone, length, vocabulary, call to
   action present when one is needed.
6. Return the text ready to paste in the target channel (plain text for chat,
   light markdown for wiki or email). Offer one alternative only when the user
   hesitated between two tones.

## Structure templates

### Status update (Progress, Plans, Problems)

One line per heading, 1 to 3 sentences each, numbers wherever possible. The
reader is someone with some but not much context on the team.

```
<Team> - <dates>
Progress: what shipped, what milestone moved, with figures.
Plans: the two or three things that matter next period.
Problems: what slows the team and what would unblock it.
```

The bigger the scope, the coarser the items: a squad lists features, a
company lists hires and deals.

### Newsletter

20 to 25 bullets, grouped in 3 to 5 sections (announcements, progress on
priorities, people, external mentions, social). One or two sentences per
bullet, a link in most of them, "we" voice. Company-wide impact only; team
detail belongs in status updates.

### FAQ answers

One question in a single sentence, one answer in one or two sentences, a link
to the authoritative source. Base answers on official communications; when the
answer is uncertain, say so and name who owns the real answer. Flag questions
that need an executive reply instead of a guess.

### Leadership note

```
Subject: <decision or risk in six words>
1. The point (one sentence: what happened or what is needed).
2. Why it matters (impact in numbers, deadline).
3. Options or recommendation (one line each).
4. What is needed from the reader, by when.
```

### Incident update

Same skeleton at every stage (investigating, identified, monitoring,
resolved): status, user impact, what is known, workaround, next update time.
No speculation about root cause until confirmed, no names of individuals.
See `examples/incident-update.md` for the sequence of posts.

## Quality bar

- First line stands alone: a reader who stops there still knows the headline.
- Every number has a unit and a comparison point when one exists.
- Links replace retelling: "see the design review" with the link, not a
  paragraph summarising it.
- Active voice, present or past tense, no passive "it was decided".
- Nothing confidential leaks: re-read with the "must not say" list.
- Fictional or placeholder content is marked as such; never pass an example as
  a real fact.

## Bundled files

- `examples/status-update.md` - two weekly updates at different scopes.
- `examples/newsletter.md` - a monthly company newsletter with sections.
- `examples/faq-answers.md` - a batch of FAQ answers with source links.
- `examples/incident-update.md` - the four posts of one incident, start to
  resolution.
Files in this package (5)
  • SKILL.md 7 KB
  • examples/faq-answers.md 2 KB
  • examples/incident-update.md 3 KB
  • examples/newsletter.md 3 KB
  • examples/status-update.md 2 KB

Versions

RepositoryScoreLicence
This page · Navinspire-ia/navin100AGPL-3.0
wrongstack/wrongstack100MIT
davila7/claude-code-templates100MIT
borghei/Claude-Skills100MIT
alirezarezvani/claude-skills100MIT
nimadorostkar/Claude-Skills-collection100MIT
bestagentkits/agency-skills100MIT
fabioc-aloha/Alex_Skill_Mall87MIT

Database snapshot: 13.11.2026 · package version 13c6c5d4a34b (SHA-256 digest of the entire package)

Downloads in the last 30 days: 2 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90team-communications
    Write internal company communications — 3P updates (Progress/Plans/Problems), company-wide newsletters, FAQ roundups, incident reports, leadership updates, status reports, project updates, and general internal comms. Use this skill any time the user asks to draft, edit, or…
  • 100writing-internal-comms
    Use when writing communication aimed at colleagues rather than users or customers — 3P updates (Progress/Plans/Problems), status reports, leadership and exec updates, company newsletters, FAQ answers, project updates, incident reports, launch announcements, or policy and…
  • 100write-update
    [Orbit 3.3.4 Docs & writing] Internal messages: status, update, announcement, FAQ, incident update. Use when: «напиши статус», «апдейт для команды», «рассылка», «статус проекта для руководства», «сообщение об инциденте»; status update, incident update message.
  • 100incident-comms
    Drafts the communications a PM owns when something is breaking or just broke — an internal escalation note, customer-facing status updates on the right cadence, a resolution/all-clear, and a short blameless postmortem for leadership. Use when you say "we have an incident", "the…
  • 90hr-employee-communications
    Help HR and internal comms teams plan and write clear, consistent employee communications across routine updates, policy changes, and sensitive announcements. Use when asked to write an internal announcement, plan our internal communications calendar, draft a policy change…
  • 95weekly-report-writer
    Create clear, friendly, privacy-safe weekly reports and status updates from notes, tickets, meetings, or work logs. Use when someone asks for a weekly report, weekly update, team summary, progress report, project status update, or a rewrite that should match a supplied reporting example and tone.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.