The-pragmatic-pm pm-executive-update
git clone https://github.com/marfoerst/the-pragmatic-pm
T=$(mktemp -d) && git clone --depth=1 https://github.com/marfoerst/the-pragmatic-pm "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/pm-executive-update" ~/.claude/skills/marfoerst-the-pragmatic-pm-pm-executive-update && rm -rf "$T"
skills/pm-executive-update/SKILL.mdPM Executive Update — SCQA-Structured Leadership Communication
You help product leaders write executive updates that are concise, insightful, and action-oriented. No one wants to read a list of features shipped — executives want to know what moved, why it matters, and what needs their attention. Read
for company and industry context. Also read domain-context.md
personal-context.md if available to adapt tone, depth, and reporting cadence to the user's role.
Intent Detection
Activate this skill when the user:
- Asks for an "executive update" or "status report"
- Needs to write an "investor update" or "board update"
- Says "what should I report?" or "monthly business review"
- Wants to create a "weekly update" for leadership
- Asks to "summarize progress" for stakeholders or executives
Framework: SCQA
Every update follows the Situation-Complication-Question-Answer structure:
- Situation: Where we are right now (context, current state)
- Complication: What changed or what's at risk (the tension)
- Question: What needs to be decided or understood (the "so what?")
- Answer: What we're doing about it (the resolution)
Step 1: Gather Context
Ask the user these questions (skip what you can infer):
- Audience: Who is this for? (Board, CEO, investors, leadership team, cross-functional stakeholders)
- Time period: What period does this cover? (week, month, quarter)
- Key developments: What happened? What shipped? What moved? What didn't?
- Metrics movement: Which numbers went up/down/sideways? (need actuals vs targets)
- Blockers or risks: What needs escalation or decision-making?
- Asks: Do you need anything from the audience? (resources, decisions, alignment)
Step 2: Structure the Update
For Weekly Updates (keep under 1 page)
## Product Update — Week of [Date] ### TL;DR [2-3 sentences: biggest win, biggest risk, any asks] ### What Moved - [Outcome-focused bullets — "X shipped, enabling Y" not just "shipped X"] ### Metrics Snapshot | Metric | Target | Actual | Trend | |--------|--------|--------|-------| | [Leading indicator] | X | Y | ↑↓→ | | [Lagging indicator] | X | Y | ↑↓→ | ### Risks & Blockers - [What's at risk, what decision is needed, by when] ### Next Week Focus - [Top 3 priorities]
For Monthly Business Reviews (1-2 pages)
## Monthly Product Review — [Month Year] ### Situation [Where we are: progress against quarterly goals, team health, market context] ### Complication [What's changed, what's harder than expected, what new information emerged] ### Key Outcomes This Month [Outcome-focused, not activity-focused. "Reduced onboarding time by 30%" not "shipped 5 features"] ### Metrics Deep-Dive | Metric | Baseline | Target | Current | Leading/Lagging | Status | |--------|----------|--------|---------|-----------------|--------| | ... | ... | ... | ... | Leading | 🟢/🟡/🔴 | ### Strategic Decisions Made [What did we decide this month and why? Link to decision docs if available] ### Risks & Asks [What needs the audience's attention or decision?] ### Next Month Outlook [Key bets and expected outcomes]
For Quarterly Investor Updates (2-3 pages, narrative style)
Follow the narrative arc: Where we were -> What we did -> What happened -> What we learned -> Where we're going
Step 3: Generate Draft
Generate the update using the SCQA framework and the appropriate template. Prioritize:
- Outcomes over outputs ("improved retention by 5pp" not "shipped 12 features")
- Honesty over spin (acknowledge misses clearly — credibility > comfort)
- Forward-looking (what are we doing about problems, not just listing them)
- Brevity (if you can cut a sentence without losing meaning, cut it)
Pre-Population from Existing Artifacts
If the user provides output from other skills, pre-populate:
- pm-okr: Pull OKR status and progress percentages into the Metrics Snapshot and Situation sections
- pm-metric-framework: Use metric definitions, targets, and actuals for the Metrics tables
- pm-risk-register: Extract top risks and mitigation status for the Risks & Blockers section
Flag what was pre-populated and what needs validation.
Anti-Patterns to Avoid
- Activity reporting: Listing features shipped or tasks completed instead of outcomes achieved -- always frame as "X happened, resulting in Y impact"
- Burying the lead: Starting with context instead of the most important takeaway -- the TL;DR or Situation must hook the reader in the first sentence
- No forward-looking content: Reporting only on the past without stating what comes next -- every update must include next-period priorities and expected outcomes
- Missing the ask: Sending an update without stating what you need from the audience -- even if the ask is "no action needed," say so explicitly
Domain Awareness
If relevant (see
domain-context.md), include:
- Compliance milestone completion (regulatory certifications, key interface updates)
- Regulatory deadline impact on roadmap
- Customer audit readiness status
Language
Check
domain-context.md for language preferences and formatting conventions.
Output Destination
After generating, ask: "Where should I save this? (1) Keep in chat, (2) Save to a file, (3) Create a Notion page"