stakeholder-brief
Scannednpx machina-cli add skill aroyburman-codes/pm-skills/stakeholder-brief --openclawStakeholder Brief Skill
Generate polished stakeholder communications — status updates, decision docs, and executive briefs.
When to Use
- User needs to write a status update for leadership
- User needs a decision document for a cross-functional review
- User needs to communicate product changes to stakeholders
- User says
/stakeholder-brieffollowed by the context - Any exec communication that needs to be clear, concise, and actionable
Document Types
Type 1: Status Update
For regular cadence updates (weekly, monthly, quarterly).
Structure:
- TL;DR (2-3 sentences): What happened, what's next, any blockers
- Key Metrics: Table of 3-5 metrics with trend arrows (up/down/flat)
- Highlights: Top 2-3 wins this period
- Lowlights: Top 1-2 challenges or misses
- Next Period Focus: What the team will prioritize
- Asks: What you need from the audience (decisions, resources, alignment)
Type 2: Decision Document
For getting alignment on a specific decision.
Structure:
- Decision Needed: One sentence stating the decision clearly
- Deadline: When this decision is needed by (and why)
- Context: 2-3 paragraphs of background (assume the reader has limited context)
- Options (3 max):
Option A Option B Option C Description Pros Cons Effort Risk - Recommendation: Which option and why (be opinionated)
- What Happens If We Don't Decide: The cost of inaction
- Appendix: Supporting data, research, or analysis
Type 3: Executive Brief
For escalations, board updates, or senior leadership.
Structure:
- Bottom Line Up Front (BLUF): One sentence conclusion/ask
- Situation: What's happening (facts only, 2-3 sentences)
- Complication: Why this matters / what changed (2-3 sentences)
- Resolution: What you propose (specific action items with owners and dates)
- Supporting Data: Key numbers in a table or bullet list
- Risks: What could go wrong with the proposed resolution
Audience Adaptation
Adjust detail level and language based on audience:
C-Suite / Board:
- Maximum 1 page
- Focus on business impact and strategic implications
- Use revenue, user growth, competitive positioning language
- Include specific asks with dollar amounts or headcount
VP / Director:
- 1-2 pages
- Include metrics AND qualitative context
- Reference OKR/goal alignment
- Include timeline and dependencies
Engineering / Cross-Functional:
- Can be longer
- Include technical details where relevant
- Use specific feature/project names
- Include clear ownership and next steps
Writing Principles
- Lead with the ask: Don't bury the lead. What do you need?
- Be specific: "Revenue up 12% QoQ" not "Revenue is trending well"
- Show your work: Link to data sources, include methodology
- Anticipate questions: Address the obvious follow-ups preemptively
- Use formatting: Tables, bold, bullet points — make it scannable
- State confidence: "We're 80% confident" is more useful than "We think"
Output Format
Generate clean markdown optimized for pasting into email, Slack, Notion, or Google Docs. Use tables for comparisons. Bold key numbers. Keep paragraphs short (2-3 sentences max).
Source
git clone https://github.com/aroyburman-codes/pm-skills/blob/main/skills/stakeholder-brief/SKILL.mdView on GitHub Overview
Stakeholder Brief helps you craft polished status updates, decision documents, and executive briefs tailored to audiences like execs, engineering, or cross-functional teams. It emphasizes clarity, conciseness, and actionable asks, speeding decision-making and alignment.
How This Skill Works
Input the topic, decision need, or status, then choose a document type and audience. The tool outputs a structured document using templates (TL;DR, KPIs, BLUF, etc.), ready for paste into email, Slack, Notion, or Google Docs. You can adjust tone and level of detail to fit leadership, engineering, or cross-functional audiences.
When to Use It
- Write a status update for leadership
- Create a decision document for cross-functional alignment
- Communicate product changes to stakeholders
- Use /stakeholder-brief with your context for quick output
- Prepare exec communications that are clear, concise, and actionable
Quick Start
- Step 1: Provide topic, decision needed, or status context
- Step 2: Choose document type and audience (Executive, VP/Director, Engineering/Cross-Functional)
- Step 3: Generate, review tone and data, and paste into your preferred tool
Best Practices
- Lead with the ask: state what you need up front
- Be specific: include concrete metrics and decisions
- Show your work: link data sources and methodology
- Anticipate questions: address obvious follow-ups
- Use formatting: tables, bold, bullets; keep it skimmable
Example Use Cases
- Type 1 Status Update for weekly leadership: TL;DR, 4 KPIs, 2 highlights, 1 blocker, next-period focus, and explicit asks
- Type 2 Decision Document for cross-functional review: 3 options with pros/cons, recommended choice, and risks
- Type 3 Executive Brief for board update: BLUF, situation, complication, proposed resolution with owners and dates
- Product change communication to stakeholders: audience-tailored language, impact, owners, and timeline
- Executive escalation brief: concise escalation with data-backed justification and requested action