Best for
- Writing weekly or monthly status updates
- Preparing for an executive review or board update
- Sharing a technical decision with a non-technical audience
rampstackco/claude-skills/skills/stakeholder-communication/SKILL.md
Communicate effectively with stakeholders across functions and seniority levels. Use this skill when writing status updates, preparing executive reviews, sharing technical decisions with non-technical audiences, managing up, communicating bad news, or designing the communication cadence for a project. Triggers on stakeholder update, status report, executive summary, exec review, manage up, communicate bad news, project comms, status meeting, weekly update. Also triggers when a project is going o
Decision brief
Get the right information to the right people at the right time, in a form they can act on. Stack-agnostic. Applies to any team operating with cross-functional stakeholders.
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/rampstackco/claude-skills --skill "skills/stakeholder-communication"Inspect the Agent Skill "stakeholder-communication" from https://github.com/rampstackco/claude-skills/blob/a67dd34c609f034c0cfd736a348659bbdf1605bf/skills/stakeholder-communication/SKILL.md at commit a67dd34c609f034c0cfd736a348659bbdf1605bf. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
Executives skim. They click into detail when interested.
Before writing, answer Q1-Q5 above. Often this clarifies the message before any drafting.
Before writing, answer Q1-Q5 above. Often this clarifies the message before any drafting.
One sentence. The takeaway. If you can't write the headline, you don't know yet what you're communicating.
Headline, so-what, body, asks, detail.
Permission review
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 92/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 779 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Get the right information to the right people at the right time, in a form they can act on. Stack-agnostic. Applies to any team operating with cross-functional stakeholders.
incident-response)documentation-strategy)Before any stakeholder communication, answer:
Specifically. "Leadership" is too vague. The CFO and the VP of Engineering have different concerns.
For each named audience:
If they read only one sentence, what should they take away?
The headline goes first. Always. The narrative supports it; the data confirms it.
This is the biggest gap in most stakeholder communication: people start with context and build to a conclusion. Stakeholders want the conclusion first.
Stakeholders ask "and?" implicitly. Answer it explicitly.
The so-what makes the information actionable.
Communications generally have one of these requests:
State which. Don't bury the request.
For most updates: async written. Save sync time for actual discussion.
Stakeholder communication reads like a news article, not an essay.
Headline (one sentence)
The "so what" and the request (one paragraph)
Status / progress (the body)
Risks and asks (what we need)
Detail / appendix (what curious readers want)
Cut from the bottom. If your update gets shortened, the top survives.
**Project:** [Name]
**Status:** [On track / At risk / Off track]
**Headline:** [One-sentence summary]
**This week:**
- [Specific accomplishment]
- [Specific accomplishment]
- [Specific accomplishment]
**Next week:**
- [Specific plan]
- [Specific plan]
**Risks / blockers:**
- [Risk + what we're doing about it / what we need]
**Metrics:**
- [Metric: value vs target]
- [Metric: value vs target]
The status indicator (on track / at risk / off track) is essential. Stakeholders scan for it.
**Headline:** [The summary, one sentence]
**Key points:**
1. [Point with one supporting sentence]
2. [Point with one supporting sentence]
3. [Point with one supporting sentence]
**Decisions needed:**
- [Decision A: options and recommendation]
- [Decision B: options and recommendation]
**Asks:**
- [Specific request]
**Detail:** [Linked doc or appendix]
Executives skim. They click into detail when interested.
The hardest update to write well.
**Headline:** [The bad news, plainly stated]
**What happened:**
[Specific facts, no euphemisms]
**Impact:**
[Who's affected, how much, by when]
**What we're doing:**
[Specific actions and owners]
**What we need:**
[Specific asks, if any]
**Timeline:**
[When the next update will land]
Don't soften the headline. Soft headlines on bad news erode trust faster than the news itself.
**Decision:** [What needs to be decided]
**Context:** [The minimum needed to understand]
**Options:**
1. [Option A: description, pros, cons]
2. [Option B: description, pros, cons]
3. [Option C: description, pros, cons]
**Recommendation:** [Option X, because...]
**Need by:** [Date]
**Decision rights:** [Who decides]
Recommendation matters. Not making one is putting the work back on the decider.
| Audience | Tone | Detail | Length |
|---|---|---|---|
| Direct manager | Candid, briefer | Mid | Medium |
| Skip-level / VP | Polished, sharper | Low | Short |
| Cross-functional peer | Collaborative, specific | Mid-high | Medium |
| Executive / board | Headlines, confident | Low (with detail available) | Short |
| Team / IC stakeholders | Detailed, direct | High | Long |
Before writing, answer Q1-Q5 above. Often this clarifies the message before any drafting.
One sentence. The takeaway. If you can't write the headline, you don't know yet what you're communicating.
Headline, so-what, body, asks, detail.
A first draft is usually 30-50% too long.
Reread. Is the ask clear? Is it specific? Is the deadline named?
Imagine the recipient reading. Will they understand the headline? Have you skipped context they need? Have you given context they don't need?
After sending:
Different audiences need different cadences.
The right cadence is what's needed, not what fills the calendar. Update people when there's something new; don't manufacture updates.
Long preamble before the point. Three paragraphs of context, then the one sentence that mattered. Lead with the point.
Status: yellow. Same status three weeks in a row. Yellow with no change is red. Be honest about progress.
Update without a clear ask. "We're working on it." OK, what do you want? If nothing, say "no action needed."
Sandwiching bad news in good news. "We've done X and Y, and unfortunately Z is delayed, but we've also done W." The bad news gets lost. Lead with it if it's the headline.
Walls of text. Too long, unread. Cut to the structure.
Activity vs outcome. "Met with team. Reviewed plan. Updated tickets." So what? "Cut scope to hit launch date" is an outcome.
Different update for every audience. Maintaining 5 versions doubles work. Have one core update; tailor the framing.
Status update that's actually a request. Buries an ask in a wall of status. Pull the ask out. Make it visible.
Optimistic projections. "We'll be back on track next week." Then we're not. Then again. Trust erodes. Be honest about the path.
No follow-up on asks. Asked for a decision; didn't get one; moved on. Now the project is stuck. Follow up.
Communicating bad news only when forced to. Stakeholders find out from someone else, or from a missed deadline. Lose trust. Communicate proactively.
Performative comms for the audience of one. Every update reads like a sales pitch to the boss. Stakeholders see through it. Be direct.
No comms when no news. Silence is worse than "no change this week." Set expectations on cadence and stick to it.
A communication plan for a project includes:
For individual communications:
references/update-templates.md: Ready-to-use templates for the most common stakeholder communications, with annotated examples.Frequently asked questions
Get the right information to the right people at the right time, in a form they can act on. Stack-agnostic. Applies to any team operating with cross-functional stakeholders.
The source record exposes this install command: npx skills add https://github.com/rampstackco/claude-skills --skill "skills/stakeholder-communication". Inspect the command and pinned source before running it.
Alternatives
prowler-cloud/prowler
PostgreSQL indexing best practices for Prowler: index design, partial indexes, partitioned table indexing, EXPLAIN ANALYZE validation, concurrent operations, monitoring, and maintenance. Trigger: When creating or modifying PostgreSQL indexes, analyzing query performance with EXPLAIN, debugging slow queries, reviewing index usage statistics, reindexing, dropping indexes, or working with partitioned table indexes. Also trigger when discussing index strategies, partial indexes, or index maintenance
brucesongs/kali-claw
Insecure Design (OWASP A06:2025) focuses on security flaws in system architecture and design phases, rather than code implementation-level bugs.
NintendaDev/unikit-ai
Generate and maintain the project's TECHNICAL documentation from its codebase — scans the project structure, tech stack, and module boundaries, then writes a lean README landing page plus detailed topic pages (architecture, modules, setup, build, APIs), only the docs that are relevant. Use whenever the user wants to create, update, or validate documentation of the CODE or the project itself, e.g. "generate documentation", "create docs", "write the README", "update the project docs", "document th
Aperivue/medsci-skills
Generate publication-ready figures and visual abstracts for medical research papers. Supports ROC curves, forest plots, CONSORT/STARD/PRISMA flow diagrams, calibration plots, Kaplan-Meier curves, Bland-Altman plots, confusion matrices, pipeline diagrams, and journal-specific visual/graphical abstracts (python-pptx template-based).