Stakeholder communication

Communicate effectively with stakeholders across functions and seniority levels.

Stakeholder communication — Creative Direction skill highlight diagram. Navy header card reads 'Impactful Creative Direction' with the subtitle… (from the rampstackco/claude-skills README)

From the rampstackco/claude-skills README — shows the whole collection, not only this skill. · view on GitHub

How to use it

Claude Code
  1. Run the line below. It pulls the whole folder into ~/.claude/skills/stakeholder-communication.
  2. Describe your job in plain words. Claude Code follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit rampstackco/claude-skills/skills/stakeholder-communication#main ~/.claude/skills/stakeholder-communication

For one project only, change the path to .claude/skills/stakeholder-communication.

Claude (web or desktop app)
  1. On this page open ⋯ → Download .md.
  2. Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
  3. Pick the file and Save. Claude shows the name and description and runs a security scan.
  4. Check the skill is switched on.
  5. Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
  1. ChatGPT: make a Project and paste it into Instructions.
  2. Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Source of Stakeholder communication

Show the full text361 lines
namedescriptioncategorycatalog_summarydisplay_order
stakeholder-communicationCommunicate 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 off track and the team needs to communicate it.process-and-teamStatus updates, exec readouts, project communications1

Stakeholder Communication

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.


When to use

  • Writing weekly or monthly status updates
  • Preparing for an executive review or board update
  • Sharing a technical decision with a non-technical audience
  • Communicating a delay, miss, or quality problem
  • Asking for help, resources, or decisions
  • Managing up to a manager or sponsor
  • Designing the communication cadence for a project
  • Drafting an internal announcement

When NOT to use

  • Customer-facing communication (use marketing/support skills)
  • Public comms or press (different framework, different stakes)
  • Incident communication during an active incident (use incident-response)
  • Internal documentation that isn't time-sensitive (use documentation-strategy)
  • Specific delivery formats (slide deck design, email tone) - this skill is about content and structure

Required inputs

  • The audience (who specifically, what's their context, what do they care about)
  • The purpose (inform, decide, escalate, ask, celebrate)
  • The substance (what's actually happening)
  • The medium (email, doc, meeting, slide, chat)
  • Time constraints (when do they need this)

The framework: 5 questions

Before any stakeholder communication, answer:

Question 1: Who is the audience?

Specifically. "Leadership" is too vague. The CFO and the VP of Engineering have different concerns.

For each named audience:

  • What do they care about? (revenue, risk, quality, velocity, costs, customers)
  • What do they already know? (background you can skip)
  • What's their level of detail tolerance? (executives want headlines; ICs want details)
  • What action do you want from them? (acknowledgment, decision, help, no action)
Question 2: What's the headline?

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.

Question 3: What's the so-what?

Stakeholders ask "and?" implicitly. Answer it explicitly.

  • "We hit 80% of the milestone." → so what?
  • "We hit 80% of the milestone, which puts the launch one week behind plan." → that's the so-what.

The so-what makes the information actionable.

Question 4: What do you want?

Communications generally have one of these requests:

  • Inform: no action needed. Just keeping them in the loop.
  • Decide: a decision is needed; here are the options and recommendation.
  • Escalate: something is stuck; we need help.
  • Ask: a specific request (resource, introduction, review).
  • Celebrate: a win to share; no action needed but morale matters.

State which. Don't bury the request.

Question 5: What format?
  • Async written (doc, email): rich content, decision trail, easy to reference
  • Sync written (chat, ticket comment): quick exchange, conversational
  • Sync spoken (meeting, call): nuance, debate, alignment
  • Mixed (doc + meeting): the doc is read in advance; meeting is decision

For most updates: async written. Save sync time for actual discussion.


The structure: the inverted pyramid

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.


Update templates

Weekly project update
**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.

Executive review
**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.

Bad news

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 request
**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.


Tone and register

Across audiences
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
What to avoid
  • Hedging when confident. "I think maybe we might be able to..." Just say what you mean.
  • Confidence when uncertain. "Definitely launching Friday" when there's risk. Calibrate.
  • Jargon for non-technical audiences. Replace with plain language.
  • Burying the lede. Headline first.
  • Implicit asks. State explicitly what you want.
  • Status updates that are 90% activity, 10% outcome. Focus on outcomes; activity is supporting evidence.

Workflow

Step 1: Define the audience and purpose

Before writing, answer Q1-Q5 above. Often this clarifies the message before any drafting.

Step 2: Draft the headline

One sentence. The takeaway. If you can't write the headline, you don't know yet what you're communicating.

Step 3: Write inverted pyramid

Headline, so-what, body, asks, detail.

Step 4: Cut

A first draft is usually 30-50% too long.

  • Cut activities that don't have outcomes
  • Cut adjectives (great, awesome, excellent, exciting)
  • Cut filler (just, really, very, actually)
  • Cut hedging (kind of, sort of, somewhat) when confident
  • Cut sentences that don't add information
Step 5: Verify the request

Reread. Is the ask clear? Is it specific? Is the deadline named?

Step 6: Check the audience

Imagine the recipient reading. Will they understand the headline? Have you skipped context they need? Have you given context they don't need?

Step 7: Send and follow up

After sending:

  • Did the right people see it? Acknowledge the right channel.
  • Did they understand? Watch for confused replies; address them.
  • Did they act? Follow up on stale asks.

Cadence design

Different audiences need different cadences.

High-frequency (weekly or more)
  • Direct team, manager, sponsor
  • Active project stakeholders
  • People making day-to-day decisions
Medium-frequency (biweekly to monthly)
  • Skip-level
  • Cross-functional partners
  • Adjacent teams
  • Strategic stakeholders
Low-frequency (quarterly)
  • Executive review
  • Board update
  • Wider organization
  • External stakeholders (where relevant)

The right cadence is what's needed, not what fills the calendar. Update people when there's something new; don't manufacture updates.


Failure patterns

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.


Output format

A communication plan for a project includes:

  • Stakeholder map: named people, their interests, their decision rights
  • Cadence: what updates go to whom, how often
  • Templates: standardized formats for repeated updates
  • Escalation paths: who to involve when something's at risk
  • Decision log: running record of decisions made, by whom, why

For individual communications:

  • Headline: the takeaway
  • Body: the supporting structure
  • Ask: the request, explicitly
  • Distribution: who gets it, in what form

Reference files

1---
2name: stakeholder-communication
3description: "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 off track and the team needs to communicate it."
4category: process-and-team
5catalog_summary: "Status updates, exec readouts, project communications"
6display_order: 1
7---
8 
9# Stakeholder Communication
10 
11Get 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.
12 
13---
14 
15## When to use
16 
17- Writing weekly or monthly status updates
18- Preparing for an executive review or board update
19- Sharing a technical decision with a non-technical audience
20- Communicating a delay, miss, or quality problem
21- Asking for help, resources, or decisions
22- Managing up to a manager or sponsor
23- Designing the communication cadence for a project
24- Drafting an internal announcement
25 
26## When NOT to use
27 
28- Customer-facing communication (use marketing/support skills)
29- Public comms or press (different framework, different stakes)
30- Incident communication during an active incident (use `incident-response`)
31- Internal documentation that isn't time-sensitive (use `documentation-strategy`)
32- Specific delivery formats (slide deck design, email tone) - this skill is about content and structure
33 
34---
35 
36## Required inputs
37 
38- The audience (who specifically, what's their context, what do they care about)
39- The purpose (inform, decide, escalate, ask, celebrate)
40- The substance (what's actually happening)
41- The medium (email, doc, meeting, slide, chat)
42- Time constraints (when do they need this)
43 
44---
45 
46## The framework: 5 questions
47 
48Before any stakeholder communication, answer:
49 
50### Question 1: Who is the audience?
51 
52Specifically. "Leadership" is too vague. The CFO and the VP of Engineering have different concerns.
53 
54For each named audience:
55- What do they care about? (revenue, risk, quality, velocity, costs, customers)
56- What do they already know? (background you can skip)
57- What's their level of detail tolerance? (executives want headlines; ICs want details)
58- What action do you want from them? (acknowledgment, decision, help, no action)
59 
60### Question 2: What's the headline?
61 
62If they read only one sentence, what should they take away?
63 
64The headline goes first. Always. The narrative supports it; the data confirms it.
65 
66This is the biggest gap in most stakeholder communication: people start with context and build to a conclusion. Stakeholders want the conclusion first.
67 
68### Question 3: What's the so-what?
69 
70Stakeholders ask "and?" implicitly. Answer it explicitly.
71 
72- "We hit 80% of the milestone." → so what?
73- "We hit 80% of the milestone, which puts the launch one week behind plan." → that's the so-what.
74 
75The so-what makes the information actionable.
76 
77### Question 4: What do you want?
78 
79Communications generally have one of these requests:
80 
81- **Inform:** no action needed. Just keeping them in the loop.
82- **Decide:** a decision is needed; here are the options and recommendation.
83- **Escalate:** something is stuck; we need help.
84- **Ask:** a specific request (resource, introduction, review).
85- **Celebrate:** a win to share; no action needed but morale matters.
86 
87State which. Don't bury the request.
88 
89### Question 5: What format?
90 
91- **Async written** (doc, email): rich content, decision trail, easy to reference
92- **Sync written** (chat, ticket comment): quick exchange, conversational
93- **Sync spoken** (meeting, call): nuance, debate, alignment
94- **Mixed** (doc + meeting): the doc is read in advance; meeting is decision
95 
96For most updates: async written. Save sync time for actual discussion.
97 
98---
99 
100## The structure: the inverted pyramid
101 
102Stakeholder communication reads like a news article, not an essay.
103 
104```
105Headline (one sentence)
106 
107The "so what" and the request (one paragraph)
108 
109Status / progress (the body)
110 
111Risks and asks (what we need)
112 
113Detail / appendix (what curious readers want)
114```
115 
116Cut from the bottom. If your update gets shortened, the top survives.
117 
118---
119 
120## Update templates
121 
122### Weekly project update
123 
124```
125**Project:** [Name]
126**Status:** [On track / At risk / Off track]
127**Headline:** [One-sentence summary]
128 
129**This week:**
130- [Specific accomplishment]
131- [Specific accomplishment]
132- [Specific accomplishment]
133 
134**Next week:**
135- [Specific plan]
136- [Specific plan]
137 
138**Risks / blockers:**
139- [Risk + what we're doing about it / what we need]
140 
141**Metrics:**
142- [Metric: value vs target]
143- [Metric: value vs target]
144```
145 
146The status indicator (on track / at risk / off track) is essential. Stakeholders scan for it.
147 
148### Executive review
149 
150```
151**Headline:** [The summary, one sentence]
152 
153**Key points:**
1541. [Point with one supporting sentence]
1552. [Point with one supporting sentence]
1563. [Point with one supporting sentence]
157 
158**Decisions needed:**
159- [Decision A: options and recommendation]
160- [Decision B: options and recommendation]
161 
162**Asks:**
163- [Specific request]
164 
165**Detail:** [Linked doc or appendix]
166```
167 
168Executives skim. They click into detail when interested.
169 
170### Bad news
171 
172The hardest update to write well.
173 
174```
175**Headline:** [The bad news, plainly stated]
176 
177**What happened:**
178[Specific facts, no euphemisms]
179 
180**Impact:**
181[Who's affected, how much, by when]
182 
183**What we're doing:**
184[Specific actions and owners]
185 
186**What we need:**
187[Specific asks, if any]
188 
189**Timeline:**
190[When the next update will land]
191```
192 
193Don't soften the headline. Soft headlines on bad news erode trust faster than the news itself.
194 
195### Decision request
196 
197```
198**Decision:** [What needs to be decided]
199 
200**Context:** [The minimum needed to understand]
201 
202**Options:**
2031. [Option A: description, pros, cons]
2042. [Option B: description, pros, cons]
2053. [Option C: description, pros, cons]
206 
207**Recommendation:** [Option X, because...]
208 
209**Need by:** [Date]
210**Decision rights:** [Who decides]
211```
212 
213Recommendation matters. Not making one is putting the work back on the decider.
214 
215---
216 
217## Tone and register
218 
219### Across audiences
220 
221| Audience | Tone | Detail | Length |
222|---|---|---|---|
223| Direct manager | Candid, briefer | Mid | Medium |
224| Skip-level / VP | Polished, sharper | Low | Short |
225| Cross-functional peer | Collaborative, specific | Mid-high | Medium |
226| Executive / board | Headlines, confident | Low (with detail available) | Short |
227| Team / IC stakeholders | Detailed, direct | High | Long |
228 
229### What to avoid
230 
231- **Hedging when confident.** "I think maybe we might be able to..." Just say what you mean.
232- **Confidence when uncertain.** "Definitely launching Friday" when there's risk. Calibrate.
233- **Jargon for non-technical audiences.** Replace with plain language.
234- **Burying the lede.** Headline first.
235- **Implicit asks.** State explicitly what you want.
236- **Status updates that are 90% activity, 10% outcome.** Focus on outcomes; activity is supporting evidence.
237 
238---
239 
240## Workflow
241 
242### Step 1: Define the audience and purpose
243 
244Before writing, answer Q1-Q5 above. Often this clarifies the message before any drafting.
245 
246### Step 2: Draft the headline
247 
248One sentence. The takeaway. If you can't write the headline, you don't know yet what you're communicating.
249 
250### Step 3: Write inverted pyramid
251 
252Headline, so-what, body, asks, detail.
253 
254### Step 4: Cut
255 
256A first draft is usually 30-50% too long.
257 
258- Cut activities that don't have outcomes
259- Cut adjectives (great, awesome, excellent, exciting)
260- Cut filler (just, really, very, actually)
261- Cut hedging (kind of, sort of, somewhat) when confident
262- Cut sentences that don't add information
263 
264### Step 5: Verify the request
265 
266Reread. Is the ask clear? Is it specific? Is the deadline named?
267 
268### Step 6: Check the audience
269 
270Imagine the recipient reading. Will they understand the headline? Have you skipped context they need? Have you given context they don't need?
271 
272### Step 7: Send and follow up
273 
274After sending:
275- Did the right people see it? Acknowledge the right channel.
276- Did they understand? Watch for confused replies; address them.
277- Did they act? Follow up on stale asks.
278 
279---
280 
281## Cadence design
282 
283Different audiences need different cadences.
284 
285### High-frequency (weekly or more)
286 
287- Direct team, manager, sponsor
288- Active project stakeholders
289- People making day-to-day decisions
290 
291### Medium-frequency (biweekly to monthly)
292 
293- Skip-level
294- Cross-functional partners
295- Adjacent teams
296- Strategic stakeholders
297 
298### Low-frequency (quarterly)
299 
300- Executive review
301- Board update
302- Wider organization
303- External stakeholders (where relevant)
304 
305The right cadence is what's needed, not what fills the calendar. Update people when there's something new; don't manufacture updates.
306 
307---
308 
309## Failure patterns
310 
311**Long preamble before the point.** Three paragraphs of context, then the one sentence that mattered. Lead with the point.
312 
313**Status: yellow.** Same status three weeks in a row. Yellow with no change is red. Be honest about progress.
314 
315**Update without a clear ask.** "We're working on it." OK, what do you want? If nothing, say "no action needed."
316 
317**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.
318 
319**Walls of text.** Too long, unread. Cut to the structure.
320 
321**Activity vs outcome.** "Met with team. Reviewed plan. Updated tickets." So what? "Cut scope to hit launch date" is an outcome.
322 
323**Different update for every audience.** Maintaining 5 versions doubles work. Have one core update; tailor the framing.
324 
325**Status update that's actually a request.** Buries an ask in a wall of status. Pull the ask out. Make it visible.
326 
327**Optimistic projections.** "We'll be back on track next week." Then we're not. Then again. Trust erodes. Be honest about the path.
328 
329**No follow-up on asks.** Asked for a decision; didn't get one; moved on. Now the project is stuck. Follow up.
330 
331**Communicating bad news only when forced to.** Stakeholders find out from someone else, or from a missed deadline. Lose trust. Communicate proactively.
332 
333**Performative comms for the audience of one.** Every update reads like a sales pitch to the boss. Stakeholders see through it. Be direct.
334 
335**No comms when no news.** Silence is worse than "no change this week." Set expectations on cadence and stick to it.
336 
337---
338 
339## Output format
340 
341A communication plan for a project includes:
342 
343- **Stakeholder map:** named people, their interests, their decision rights
344- **Cadence:** what updates go to whom, how often
345- **Templates:** standardized formats for repeated updates
346- **Escalation paths:** who to involve when something's at risk
347- **Decision log:** running record of decisions made, by whom, why
348 
349For individual communications:
350 
351- **Headline:** the takeaway
352- **Body:** the supporting structure
353- **Ask:** the request, explicitly
354- **Distribution:** who gets it, in what form
355 
356---
357 
358## Reference files
359 
360- [`references/update-templates.md`](references/update-templates.md): Ready-to-use templates for the most common stakeholder communications, with annotated examples.
361 

Discussion