Get the FREE Ultimate OpenClaw Setup Guide →

stakeholder-brief

Scanned
npx machina-cli add skill aroyburman-codes/pm-skills/stakeholder-brief --openclaw
Files (1)
SKILL.md
3.6 KB

Stakeholder 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-brief followed 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:

  1. TL;DR (2-3 sentences): What happened, what's next, any blockers
  2. Key Metrics: Table of 3-5 metrics with trend arrows (up/down/flat)
  3. Highlights: Top 2-3 wins this period
  4. Lowlights: Top 1-2 challenges or misses
  5. Next Period Focus: What the team will prioritize
  6. Asks: What you need from the audience (decisions, resources, alignment)

Type 2: Decision Document

For getting alignment on a specific decision.

Structure:

  1. Decision Needed: One sentence stating the decision clearly
  2. Deadline: When this decision is needed by (and why)
  3. Context: 2-3 paragraphs of background (assume the reader has limited context)
  4. Options (3 max):
    Option AOption BOption C
    Description
    Pros
    Cons
    Effort
    Risk
  5. Recommendation: Which option and why (be opinionated)
  6. What Happens If We Don't Decide: The cost of inaction
  7. Appendix: Supporting data, research, or analysis

Type 3: Executive Brief

For escalations, board updates, or senior leadership.

Structure:

  1. Bottom Line Up Front (BLUF): One sentence conclusion/ask
  2. Situation: What's happening (facts only, 2-3 sentences)
  3. Complication: Why this matters / what changed (2-3 sentences)
  4. Resolution: What you propose (specific action items with owners and dates)
  5. Supporting Data: Key numbers in a table or bullet list
  6. 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

  1. Step 1: Provide topic, decision needed, or status context
  2. Step 2: Choose document type and audience (Executive, VP/Director, Engineering/Cross-Functional)
  3. 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

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers