skills/stakeholder-comms/SKILL.md
Communicating effectively up, down, and laterally within an org chart. Use when: preparing an executive briefing, presenting to leadership, managing stakeholder expectations, negotiating priorities with product or peer teams, escalating issues, delivering difficult messages, or building influence without authority.
npx skillsauth add michaelsvanbeek/personal-agent-skills stakeholder-commsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
## [Topic] — [Date]
### Bottom Line
[1–2 sentences: the key message. Put the most important thing first.]
### Context
[2–3 sentences: enough background for the reader to understand the situation]
### Options
| Option | Pros | Cons | Effort | My Rec |
|--------|------|------|--------|--------|
| A | ... | ... | ... | ← |
| B | ... | ... | ... | |
| C (do nothing) | ... | ... | ... | |
### Recommendation
[Which option and why, in 2 sentences]
### Ask
[Specific: "I need a decision by Friday" or "Approve option A so we can proceed"]
## [Topic] — Cross-Team Update
### Context
[What's happening and why does it affect both teams?]
### Our Plan
[What we're doing and our timeline]
### What We Need From You
[Specific, timeboxed asks]
### What You Can Expect From Us
[Deliverables and dates]
### Open Questions
[Things we need to resolve together]
When you need to escalate an issue:
## Escalation: [Issue Title]
### Situation
[What is happening — factual, no editorializing]
### Impact
[Business impact: customers affected, revenue at risk, timeline delay]
### What We've Tried
[Steps already taken to resolve]
### What We Need
[Specific decision or action from the escalation recipient]
### Timeline
[How urgent: "Need a decision by EOD" or "Blocking until resolved"]
"I understand the importance of [their request]. Here's the trade-off:
taking this on would mean [what we'd have to deprioritize].
My recommendation is [alternative approach]. If [their request] is the
higher priority, I'm open to adjusting — I just want to make sure we're
making that trade-off intentionally."
| Anti-Pattern | Problem | Better Approach | |-------------|---------|----------------| | Burying bad news | Erodes trust when discovered | Lead with the most important/difficult item | | Presenting problems without solutions | Makes you a messenger, not a leader | Always propose a path forward | | Using team jargon with execs | They don't understand and won't ask | Translate to business language | | Escalating without trying first | Burns political capital | Document what you've tried before escalating | | Vague asks | "Provide more support" vs. "Approve 1 additional headcount" | Make every ask specific and actionable | | Over-communicating | People tune out | Match detail to audience; less is more for execs |
development
TypeScript coding standards and type safety conventions. Use when: creating TypeScript files, defining interfaces and types, writing type-safe code, reviewing TypeScript for type correctness, auditing a codebase for type safety gaps, eliminating any or ts-ignore usage, or improving strict-mode compliance. Covers strict typing, avoiding any and ts-ignore, discriminated unions, Zod runtime validation, immutability patterns, and proper type definitions.
testing
Writing clear, actionable tickets in any issue tracker (Jira, Linear, GitHub Issues, ServiceNow, etc.). Use when: creating epics, stories, tasks, bugs, or spikes; writing acceptance criteria; decomposing work for a sprint; linking dependencies between tickets; auditing backlog items for clarity; or coaching a team on ticket quality. Covers title conventions, description templates, acceptance criteria, decomposition rules, dependency linking, and org-specific pluggable configuration.
development
Testing strategy, patterns, and evaluation for software and LLM/AI systems. Use when: writing tests, choosing test boundaries, designing test data, structuring test suites, evaluating LLM outputs, building evaluation pipelines, setting coverage thresholds, auditing test coverage gaps in existing projects, or improving test quality and structure.
development
Writing effective status updates for different audiences and cadences. Use when: writing a weekly status update, preparing a monthly summary, drafting a quarterly review, sending updates to leadership, sharing progress with stakeholders, or improving the clarity and impact of team communications. Covers weekly, monthly, and quarterly formats tailored for upward, lateral, and downward communication.