Agent Skills
› mohitagw15856/pm-claude-skills
› stakeholder-update
stakeholder-update
GitHub基于BLUF框架为高管和利益相关者生成简洁的状态更新报告。涵盖进度、指标、风险及决策需求，支持读取Brain上下文以个性化内容，确保2分钟内可读。
Trigger Scenarios
撰写项目状态更新
生成执行层进度报告
制作高管简报
编写利益相关者沟通材料
Install
npx skills add mohitagw15856/pm-claude-skills --skill stakeholder-update -g -y
SKILL.md
Frontmatter
{
"name": "stakeholder-update",
"description": "Create concise executive stakeholder updates using the BLUF (Bottom Line Up Front) framework. Use when asked to write a status update, progress report, project communication, or executive briefing for leadership or stakeholders. Produces a BLUF-led update with status, key metrics, risks, upcoming milestones, and decisions needed — readable in under 2 minutes."
}
Stakeholder Update Skill
This skill creates effective status updates for executives and stakeholders following the BLUF (Bottom Line Up Front) principle.
Required Inputs
Ask the user for these if not provided:
- Project or product being reported on
- Audience (CEO, board, cross-functional leads, investors — changes depth and format)
- Period (this week / this sprint / this month)
- Current status (on track / at risk / blocked)
- Key metrics and their current values vs. targets
Reads from / Writes to the Brain
If a professional-brain (brain/) exists, use it before asking:
- Read first: the relevant
stakeholders/files (what each person cares about and their prior asks),context.md(voice/tone), and recentdecisions/for what's changed since the last update. - Write after: append any new ask, concern, or commitment surfaced to the relevant
stakeholders/file, provenance-tagged ([verbal]for something said in a meeting, not yet documented).
Deeper Materials
references/status-honesty-guide.md— calibration for the 🟢/🟡/🔴 call (the watermelon problem, the consecutive-🟡 rule, re-baselining honestly) and fact → impact → action → ask phrasing for bad news. Apply it whenever the status is 🟡/🔴 or the input notes feel rosier than the metrics.templates/update-skeleton.md— a one-page fill-in update with the quality gates inline and a pre-send checklist. Offer it to users who want to write updates themselves.
Update Structure
1. BLUF (Bottom Line Up Front)
Start with the most important information:
- Status: 🟢 On track / 🟡 At risk / 🔴 Blocked / ✅ Complete
- Key Takeaway: One sentence summary of current state
- Action Needed: What you need from stakeholders (if anything)
2. Progress Summary
Brief overview of accomplishments:
- What shipped this period
- Milestones achieved
- Key metrics movement
Keep to 3-5 bullet points maximum.
3. Metrics Dashboard
Key Metrics
| Metric | Current | Target | Trend | Status |
|---|---|---|---|---|
| [Metric name] | [Value] | [Target] | ↑/→/↓ | 🟢/🟡/🔴 |
Include 3-5 most important metrics only.
4. Risks & Blockers
High Priority Issues:
- Issue: Brief description
- Impact: What's at stake
- Mitigation: What you're doing about it
- Help Needed: What stakeholders can do (if applicable)
Only include issues that matter at executive level.
5. Upcoming Milestones
Next 30 Days:
- Milestone (expected date)
- Milestone (expected date)
Next 90 Days:
- Major milestone (month)
- Major milestone (month)
6. Decisions Needed (if applicable)
- Decision: Clear description
- Options: 2-3 options with pros/cons
- Recommendation: What you recommend and why
- Timeline: When decision is needed
Writing Guidelines
Tone: Professional, concise, action-oriented Length: Keep under 1 page (or 2 minutes reading time) Frequency: Weekly for active projects, bi-weekly for maintenance
Executive Communication Principles:
-
Lead with conclusions, not process
- ❌ "We ran 5 experiments this week and analyzed the data..."
- ✅ "Conversion rate increased 15% from optimization work"
-
Focus on impact, not activities
- ❌ "Held 12 customer interviews"
- ✅ "Identified #1 barrier to adoption (complexity of setup)"
-
Make problems visible early
- Don't sugarcoat risks
- Propose solutions, not just problems
- Be specific about help needed
-
Use data to tell story
- Quantify whenever possible
- Show trends, not just snapshots
- Connect metrics to business outcomes
-
Make it scannable
- Use headers and bullet points
- Bold key information
- Use visual indicators (🟢🟡🔴, ↑→↓)
Status Guidelines
🟢 On Track: Meeting all targets, no significant risks 🟡 At Risk: Potential issues that could impact delivery 🔴 Blocked: Critical issues preventing progress, needs intervention
Example Update
# Product Update: Customer Onboarding Redesign
**Week of Jan 20, 2026**
## BLUF
**Status**: 🟡 At Risk
**Key Takeaway**: New onboarding flow is performing well in tests (+35% completion), but launch delayed one week due to integration issues with billing system.
**Action Needed**: Decision needed on whether to launch onboarding separately or wait for billing integration fix.
## Progress Summary
- Completed user testing with 24 participants (94% positive feedback)
- Implemented first-time user experience improvements
- Resolved 12 of 15 bugs identified in QA
- Engineering allocated resources to billing integration fix
## Key Metrics
| Metric | Current | Target | Trend | Status |
|--------|---------|--------|-------|--------|
| Onboarding Completion | 45% | 60% | → | 🟡 |
| Time to First Value | 4.2 min | 3.0 min | ↓ | 🟢 |
| Setup Support Tickets | 45/week | <30/week | ↓ | 🟢 |
| User Activation Rate | 52% | 65% | → | 🟡 |
## Risks & Blockers
**HIGH: Billing System Integration Delay**
- **Impact**: Prevents users from completing onboarding flow; delays launch by 1-2 weeks
- **Root Cause**: API deprecation by payment processor, requires code rewrite
- **Mitigation**: Engineering team reallocated resources, fix ETA Feb 3
- **Decision Needed**: Launch onboarding without payment integration or wait for fix? (See below)
**MEDIUM: Mobile Testing Coverage**
- **Impact**: Some edge cases on older Android devices not tested
- **Mitigation**: Partnering with QA to expand test matrix; running beta with internal users on diverse devices
## Upcoming Milestones
**Next 30 Days:**
- Resolve billing integration (Feb 3)
- Launch onboarding redesign (Feb 5 or Feb 12 depending on decision)
- Begin measuring impact on conversion (Feb 12)
**Next 90 Days:**
- Iterate based on production data (March)
- Extend to mobile app (April)
- Launch advanced features (May)
## Decision Needed
**Should we launch onboarding separately from billing integration?**
**Option A: Launch Now (Recommended)**
- Pros: Get 35% completion rate improvement to users immediately, gather production data, maintain momentum
- Cons: Users need to complete payment in old flow, slightly disjointed experience
- Timeline: Launch Feb 5
**Option B: Wait for Billing Fix**
- Pros: Fully integrated experience from day one, no technical debt
- Cons: Delays benefits by 2 weeks, Q1 metric targets at risk, team momentum lost
- Timeline: Launch Feb 12
**Recommendation**: Option A. The onboarding improvements are valuable independently, and the old payment flow works fine. Waiting risks missing Q1 targets and delays validated improvements from reaching users.
**Timeline**: Need decision by Jan 22 for Feb 5 launch.
---
**Questions?** Reply to this email or ping me on Slack.
Frequency Guidance
Daily standups:
- Ultra-brief (3 bullets)
- What shipped yesterday
- What's shipping today
- Blockers
Weekly updates:
- Use full template above
- Focus on progress and risks
- Keep to 1 page
Monthly reviews:
- Deeper metrics analysis
- Strategic reflections
- Quarterly goal progress
- Longer format (2-3 pages) acceptable
Quarterly business reviews:
- Comprehensive analysis
- Trends over time
- Strategic recommendations
- Presentation format
Adaptation by Audience
For C-Suite
- Lead with business impact
- Connect to company OKRs
- Focus on strategy and outcomes
- Minimize technical details
For Product/Engineering Leadership
- Include technical context
- Show sprint/milestone progress
- Discuss architecture implications
- Reference technical debt
For Cross-Functional Teams
- Balance technical and business context
- Highlight dependencies
- Call out collaboration needs
- Make asks explicit
For Board/Investors
- Focus on metrics and traction
- Competitive positioning
- Market opportunities
- Financial implications
Quality Checks
- Update leads with BLUF — status, key takeaway, and action needed before any detail
- Every metric has a target comparison (not just a raw number)
- Every risk has a mitigation and a "help needed" flag if stakeholder action is required
- Decisions needed have specific options and a clear recommendation
- Total length is under 1 page / 2 minutes reading time
Anti-Patterns
- Do not bury the status assessment at the bottom — BLUF means the most important information comes first
- Do not report metrics without a target or prior-period comparison — raw numbers without context are not useful
- Do not list risks without mitigation actions and clear flags for stakeholder help needed
- Do not write decisions needed as questions without providing a clear recommendation — executives need options, not open-ended questions
- Do not allow the update to exceed one page — if it requires more, the message needs editing, not expanding
Execution
For tool-using agents that can reach the team's communication channels (Slack, email). Sending an update is outward-facing: it is never automatic. Runtimes without tool access ignore this section. See SKILLSPEC.md §5.
Preconditions
- The final update text has been shown to the human verbatim and explicitly approved — including the exact channel/recipient list.
- The channel or recipient list is named by the user, not inferred from history.
- If the status is 🔴 or contains a Decision Needed, confirm the named decision-maker is among the recipients.
Allowed actions
- Post the approved text, unmodified, to the one approved channel — or send it as one email to the approved recipients with the approved subject line.
- Save a copy to the location the user names (doc, Brain, repo file).
- Nothing else: no scheduling recurring sends (see
schedule-recipefor that, with its own gates), no @-mentions not present in the approved text, no cross-posting.
Verification
- Confirm the message exists in the channel/thread (fetch its permalink) and report the link back.
- Confirm the sent text is byte-identical to the approved text.
Rollback
- If the platform allows it, deletion of a just-posted message is permitted only on explicit human instruction — otherwise post a correction reply.
- Stop and ask a human if: the channel is not found, posting partially fails, or the approved text no longer matches what is about to be sent.
Version History
- a38bc30 Current 2026-07-05 11:44
