exec-comms
Skill0 starsChanged 27 days agoMITView on GitHub
Write executive-level business communication — board updates, QBRs, stakeholder updates, escalations, proposals, and decision memos — structured so the reader gets the decision in the first paragraph. Use this whenever the user asks to write or review something going to executives, a board, a leadership team, or a customer sponsor, including a board update, QBR deck, exec summary, status report, decision memo, escalation, budget request, or "make this shorter and sharper for leadership". Also use it when a draft buries its ask under context.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- menkesu/awesome-pm-skillstheir own version, first seen Oct 13, 2026
- Jiplet/transformation-ostheir own version, first seen Jul 2, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- menkesu/awesome-pm-skills★ 441same name
- Jiplet/transformation-os★ 2same 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 repository9 other files it gives its agents.
- AGENTS.mdAGENTS.md
- campaign-planSkill
- competitive-briefSkill
- deal-qualificationSkill
- icp-scoringSkill
- market-sizingSkill
- positioningSkill
- pricing-strategySkill
- value-caseSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 9 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Put the answer first. Then support it.
- Distinctive: line 18
Every executive document is a variation on this shape:
- Distinctive: line 28
If the reader stops after section 1, they should still be able to act.
- Distinctive: line 83
Bring the plan: Not a full recovery plan — the next concrete step, its owner, and when you will know if it worked.
- Distinctive: line 97
What changed since last time: Only material changes.
- Very specific: line 142
If you built the original business case with value-case, revisit it here with real numbers.
- Distinctive: line 151
When you will next update them.
- Distinctive: line 158
After the draft, run these four passes:
- Distinctive: line 162
Delete every sentence that survives its own deletion: If removing it changes nothing, it was there for rhythm, not information.
- Distinctive: line 176
Burying the ask: If you need a decision, the word "approve" or "decide" should appear early and unmistakably.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Executive communication
Executives read differently. They are scanning for a decision, a risk, or a number, across a queue of documents that all want something. The writing convention most people learned — build context, develop the argument, arrive at the conclusion — is precisely backwards for this reader, because it makes them work through material they may not need to reach the part they do.
Put the answer first. Then support it. Then, only if needed, the background.
The structure
Every executive document is a variation on this shape:
1. The ask or the answer (1-3 sentences)
2. Why, in three points (the supporting logic)
3. What it costs / what it risks (the honest downside)
4. What happens next (owner, date)
5. Appendix (everything else)If the reader stops after section 1, they should still be able to act. That is the test. Write section 1 last, once you know what you are actually saying, and then check whether the rest is needed at all.
Section 1 in practice
State the decision being requested, the recommendation, and the deadline:
Asking for approval to move the Northwind renewal to a 3-year term at a 12% discount, by September 30. This trades $71k of year-one revenue for $340k of committed multi-year revenue and removes the competitive risk flagged in July. Recommend approving.
Everything a busy reader needs is there: what, how much, why, by when, and what you think. Compare against the version that opens with "As you know, Northwind has been a customer since 2023..." — which asks the reader to hold context before knowing what it is for.
SCQA, when you need a narrative
For documents that must persuade rather than just inform, the Situation— Complication—Question—Answer frame is the most reliable structure available:
- Situation — the stable context both parties agree on.
- Complication — what changed, creating tension.
- Question — what that forces us to decide.
- Answer — the recommendation.
Its power is that the reader arrives at your question themselves. By the time the answer appears, they are already asking for it. Keep Situation to one or two sentences; a long Situation is where executive documents go to die.
Numbers
Round to the precision the estimate supports. $1.2M says you have decided
what matters. $1,247,318.44 says you have not.
Always give a comparison. A number alone is uninterpretable. "$340k" means nothing; "$340k, up from $290k last year, against a $325k target" means something. Every important number needs one of: prior period, plan, or benchmark.
Say what the number does not include. Volunteering the limit of your own figure is the cheapest credibility available, and it costs you almost nothing because a competent reader would have asked.
Bad news
Bad news travels badly when it is managed. It travels fine when it is reported.
Lead with it. Burying a miss in paragraph four means the reader finds it themselves and now distrusts the first three paragraphs.
Give the number and the cause separately. Executives can hold both. Merging them into an explanation reads as an excuse even when it is not.
Bring the plan. Not a full recovery plan — the next concrete step, its owner, and when you will know if it worked.
Do not pre-emptively apologize. It shifts the reader's attention from the problem to managing your feelings about it. Report, recommend, move on.
Recurring formats
Board update
Written for people with limited context and high judgment. What they need:
- Headline metrics against plan. Three to five. Same metrics every time — changing them reads as hiding something even when it is not.
- What changed since last time. Only material changes.
- The one or two things you want their help with. The most underused section in board reporting. Boards are a resource; a board update that asks for nothing wastes it.
- Risks, with what you are doing about each.
Consistency period-over-period matters more than completeness in any single update. A board that can compare this quarter to last quarter without re-learning your format gets far more out of it.
Pipeline and forecast slides
Board updates and internal QBRs almost always carry a pipeline slide, and it is the slide most often built from arithmetic done by hand on stage probabilities nobody sourced. Compute it instead:
PYTHONPATH="${CLAUDE_PLUGIN_ROOT}" python3 -m gtmkit.pipeline pipeline.csv \
--stages stages.json --target 1200000 --closed 95000 \
--period-end 2026-12-31 --as-of 2026-10-06Then write it the way this skill writes everything else. Lead with the expected landing against target, and the commit number. Put coverage next to the coverage the stage probabilities need — a bare "2.2x" invites the reader to compare it with a rule of thumb that does not fit your stage mix. Carry the spread with the forecast ("$1.0M expected, ±$330k"), because a lone forecast figure is precision outrunning the estimate. If the engine graded the probabilities D or F, or ran on its placeholder model, say so on the slide: it is the limit a board member would otherwise find for you. Use the same stage model every period, for the same reason you keep the same metrics.
The file format and the stage model are in the pipeline format reference.
Customer QBR
The mistake is making it a status report. A QBR is a business review with the customer's business at the center.
- What they set out to achieve — in their words, from the original case.
- What actually happened — measured, including where it fell short.
- What it produced — value delivered, against the original model.
- What is next — jointly, not a list of things you want to sell.
If you built the original business case with value-case, revisit it here with
real numbers. A vendor who returns with "here is what we projected and here is
what actually happened, including where we were wrong" is in a category of one.
Escalation
- What is broken, and the impact in their terms.
- What has been done so far.
- What you need from the reader, specifically.
- When you will next update them.
Point three is the entire message. An escalation without a specific ask is a complaint.
Editing
After the draft, run these four passes:
Cut the first paragraph. It is warm-up, roughly 70% of the time.
Delete every sentence that survives its own deletion. If removing it changes nothing, it was there for rhythm, not information.
Find hedges and decide. "We believe it may be possible that" is either a recommendation or it is not. Executives read hedging as either an absence of a view or an attempt to avoid accountability for one.
Read section 1 alone. Could the reader act on it? If not, rewrite it — and resist the urge to fix it by adding section 2 into section 1.
Common failures
Context before conclusion. The default failure, and the most expensive.
Burying the ask. If you need a decision, the word "approve" or "decide" should appear early and unmistakably.
Metric drift. Changing which metrics you report between updates destroys comparability and looks evasive.
Precision that outruns the estimate. Four significant figures on a number built from a wide assumption is a claim the underlying work cannot support.
Passive voice around accountability. "Mistakes were made" tells the reader nothing they can act on and costs you the credibility that naming it would have bought.
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.

