comms
Skill1 starsChanged 7 months agoMITView on GitHub
Writing for specific audiences: leadership, peers, team, and org-wide. Use when: preparing an executive briefing, writing a team newsletter, communicating up/down/ laterally, announcing a launch or change, escalating an issue, delivering difficult messages, pushing back on a request, or building team visibility across the org.
9 other projects use a version of this.
Adopted by
Most recently taken up by
- musterd-io/musterdtheir own version, first seen Nov 1, 2026
- mikhin/claude-skillstheir own version, first seen Oct 13, 2026
- chriswestt/claude-skillstheir own version, first seen Oct 9, 2026
- grandamenium/cortextostheir own version, first seen Oct 9, 2026
- sandraschi/comms-mcptheir own version, first seen Oct 8, 2026
- skyf0xx/gambittheir own version, first seen Sep 30, 2026
Other versions9 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 9
- grandamenium/cortextos★ 106same name
- skyf0xx/gambit★ 29same name
- bouob/sysadmin-skills★ 2same name
- cacardinal/laila★ 1same name
- musterd-io/musterd★ 1same name
- sandraschi/comms-mcp★ 1same name
- chriswestt/claude-skills★ 0same name
- Endika/eskills★ 0same name
- mikhin/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository42 other files it gives its agents.
- accessibility-testingSkill
- alternatives-analysisSkill
- anomaly-detectionSkill
- api-designSkill
- async-messagingSkill
- caching-strategiesSkill
- chartsSkill
- cicdSkill
- code-reviewSkill
- critical-feedbackSkill
- data-analysisSkill
- databaseSkill
- data-migrationsSkill
- data-visualizationSkill
- dependency-managementSkill
- dockerSkill
- error-handlingSkill
- feature-flagsSkill
- git-workflowSkill
- goalsSkill
- ide-setupSkill
- large-changeSkill
- logging-metricsSkill
- markdown-docsSkill
- mcp-serverSkill
- meeting-agendasSkill
- okrsSkill
- presentationsSkill
- product-managementSkill
- prompt-writingSkill
- pythonSkill
- reclassificationSkill
- release-managementSkill
- retrospectivesSkill
- roadmap-planningSkill
- securitySkill
- stakeholder-commsSkill
- statisticsSkill
- status-updatesSkill
- testingSkill
- ticket-writingSkill
- typescriptSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 7 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 9 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 74
Don't bury the lede — if the project is off track, say so first
- Distinctive: line 76
Use their language (revenue, retention) not yours (story points, tech debt)
- Distinctive: line 105
Document agreements — follow up Slack with a written summary or email
- Distinctive: line 116
Don't sugarcoat — teams respect honesty
- Distinctive: line 123
Keep it accessible to non-engineers.
- Distinctive: line 157
Keep it scannable — bullets, headers, bold key phrases
- Distinctive: line 196
Document the issue, impact, and what you've tried
“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Communications
When to Use
- Preparing an executive briefing or leadership update
- Writing a team or org newsletter
- Announcing a launch, migration, or deprecation
- Managing expectations when timelines slip
- Negotiating priorities with peers or product
- Escalating a blocking issue
- Delivering difficult messages
- Building team visibility across the org
For recurring status updates (weekly, monthly, quarterly), see the status-updates skill.
Principles
- Know your audience — tailor depth, language, and framing
- Lead with "so what" — why should this person care? Start there.
- Be direct — state your point in the first 2 sentences
- Propose, don't just present — come with a recommendation
- Quantify — numbers build credibility
- Close the loop — end with a clear next step or ask
Writing for Each Audience
Upward (Manager, VP, Exec)
They care about: business impact, risks, decisions needed, confidence level.
Executive Briefing
## [Topic] — [Date]
### Bottom Line
[1–2 sentences: the key message. Most important thing first.]
### Context
[2–3 sentences: enough background to understand]
### Options
| Option | Pros | Cons | Effort | Rec |
|--------|------|------|--------|-----|
| A | ... | ... | ... | ← |
| B | ... | ... | ... | |
### Recommendation
[Which option and why — 2 sentences]
### Ask
[Specific: "I need a decision by Friday" or "Approve option A"]Tips:
- Don't bury the lede — if the project is off track, say so first
- Frame problems with solutions — "X is at risk. My plan: Y"
- Use their language (revenue, retention) not yours (story points, tech debt)
- Pre-wire important decisions — align with your manager before the VP meeting
Lateral (Peer EMs, PMs, Designers)
They care about: dependencies, shared priorities, capacity, coordination.
## [Topic] — Cross-Team Update
### Context
[What's happening and why it affects both teams]
### Our Plan
[What we're doing and our timeline]
### What We Need From You
[Specific, timeboxed asks]
### What You Can Expect From Us
[Deliverables and dates]
### Open Questions
[Things to resolve together]Tips:
- Be transparent about constraints
- Negotiate, don't mandate — you have influence, not authority
- Document agreements — follow up Slack with a written summary or email
- Proactive > reactive
Downward (Your Team)
They care about: context, impact on their work, recognition, honesty.
Tips:
- Share context generously — the "why" matters more than the "what"
- Be transparent about uncertainty
- Celebrate publicly, coach privately
- Don't sugarcoat — teams respect honesty
- Repeat important messages across channels
Org-Wide (Broad Audience)
They care about: high-level impact, customer stories, team culture.
Keep it accessible to non-engineers. Good for team visibility and recruiting.
Newsletter Format
Cadence: bi-weekly or monthly Channel: Slack, email, or Confluence Length: 3–5 minutes to read
# [Team Name] Update — [Date]
## Wins
- [Win with impact] — [brief context]
- [Win with impact]
## What's Coming
- [Initiative] — expected by [date], enables [outcome]
## By the Numbers
- [Metric]: [current] (from [previous])
## Spotlight
[Person or topic] — [what happened and why it matters]
## Links
- [Confluence page, demo recording, or dashboard]Rules:
- Lead with impact, not effort
- Name people — recognition builds morale and visibility
- Include visuals when possible — charts, screenshots
- Keep it scannable — bullets, headers, bold key phrases
- Consistent cadence — same schedule every time
Announcements (launches, deprecations, changes)
# [Announcement Title]
## What's Changing
[1–2 sentences]
## Why
[1–2 sentences]
## Impact
[Who is affected and how]
## Timeline
| Date | Milestone |
|------|-----------|
## What You Need to Do
[Numbered action items]
## Questions?
[Slack channel, FAQ link, contact person]Post the announcement before the change, not after.
Escalation
Before Escalating
- Attempt to resolve at the current level
- Document the issue, impact, and what you've tried
- Notify the other party that you plan to escalate
Escalation Message
## Escalation: [Issue]
### Situation
[Factual, no editorializing]
### Impact
[Business impact: customers, revenue, timeline]
### What We've Tried
[Steps taken]
### What We Need
[Specific decision or action]
### Timeline
[Urgency: "Need a decision by EOD"]Stick to facts. Quantify impact. Propose a path forward.
Pushing Back
"I understand the importance of [their request]. Here's the trade-off:
taking this on would mean [what we'd deprioritize].
My recommendation is [alternative]. If [their request] is the higher
priority, I'm open to adjusting — I want to make sure we're making
that trade-off intentionally."Delivering Bad News
- Be direct — "We're going to miss the deadline by two weeks"
- Own it — acknowledge what your team could have done differently
- Bring a plan — bad news + recovery plan is 10× better than bad news alone
- Give advance notice — get ahead of it
Anti-Patterns
| Anti-Pattern | Fix |
| Burying bad news | Lead with the most important item |
| Problems without solutions | Always propose a path forward |
| Jargon with execs | Translate to business language |
| Vague asks | Make every ask specific and actionable |
| Over-communicating | Match detail to audience; less is more for execs |
| Forgetting to name people | Always credit individuals |
Related Skills
- status-updates — Recurring cadence-based updates
- planning — Presenting plans to stakeholders
- meeting-facilitation — Running effective meetings
- inbox-management — Triaging incoming communications
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

