Communicate effectively with stakeholders across functions and seniority levels. Use this skill when writing status updates, preparing executive reviews, sharing technical decisions with non-technical audiences, managing up, communicating bad news, or designing the communication cadence for a project. Triggers on stakeholder update, status report, executive summary, exec review, manage up, communicate bad news, project comms, status meeting, weekly update. Also triggers when a project is going off track and the team needs to communicate it.
62
73%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/stakeholder-communication/SKILL.mdQuality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid description with strong completeness and trigger term coverage. It explicitly states both what the skill does and when to use it, with a comprehensive list of trigger terms. The main weaknesses are that the capability descriptions could be more concrete (specific deliverables rather than categories) and the domain could overlap with general writing or project management skills.
Suggestions
Make capabilities more concrete by specifying deliverables, e.g., 'Drafts status emails, creates executive review decks, writes escalation messages' rather than broad categories like 'communicating bad news'.
Add distinguishing details that separate this from general writing or project management skills, e.g., 'Focuses on framing, audience adaptation, and communication strategy rather than content creation or project planning.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (stakeholder communication) and lists several actions like 'writing status updates, preparing executive reviews, sharing technical decisions with non-technical audiences, managing up, communicating bad news, designing communication cadence.' These are reasonably specific but lean more toward categories of communication rather than concrete, granular actions (e.g., 'draft a status email', 'create an executive slide deck'). | 2 / 3 |
Completeness | Clearly answers both 'what' (communicate effectively with stakeholders across functions and seniority levels) and 'when' with an explicit 'Use this skill when...' clause listing multiple scenarios, plus a dedicated 'Triggers on' list and an additional situational trigger. Both dimensions are well-covered. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would actually say: 'status update', 'executive summary', 'exec review', 'manage up', 'communicate bad news', 'weekly update', 'status report', 'project comms', 'status meeting'. The description also includes a situational trigger ('project is going off track') which adds natural language coverage. | 3 / 3 |
Distinctiveness Conflict Risk | While the description carves out a niche around stakeholder communication, terms like 'status update', 'executive summary', and 'weekly update' could overlap with general writing or project management skills. The broad phrase 'communicate effectively with stakeholders' is somewhat generic and could conflict with other communication-oriented skills. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable communication skill with excellent templates and a clear framework. Its main weaknesses are verbosity (several sections could be tightened without losing value) and the amount of inline content that could benefit from being split into reference files. The workflow is logical but would be stronger with explicit validation gates.
Suggestions
Trim the failure patterns section to a concise table or bullet list of pattern → fix pairs, cutting roughly 50% of the prose.
Move the detailed templates and the tone/register table into a referenced file (e.g., references/update-templates.md) and keep only one example template inline.
Add explicit validation gates in the workflow, e.g., 'If you cannot write the headline in one sentence, return to Step 1 and clarify the purpose before proceeding.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-structured but verbose for its domain. Several sections explain things Claude already understands (e.g., what async vs sync communication is, what hedging means). The failure patterns section, while useful, is lengthy and could be condensed. The 'when NOT to use' and 'required inputs' sections add moderate value but pad the token count. | 2 / 3 |
Actionability | The skill provides concrete, copy-paste-ready templates for weekly updates, executive reviews, bad news, and decision requests. The 5-question framework is specific and immediately applicable. The tone/register table gives precise guidance per audience type. Every section translates directly into action. | 3 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced and logical, but lacks explicit validation checkpoints or feedback loops. Steps 5 and 6 are review steps but aren't framed as gates (e.g., 'if the ask isn't clear, go back to step 2'). For a communication skill where errors can damage trust, the workflow would benefit from explicit go/no-go checks. | 2 / 3 |
Progressive Disclosure | The skill references one external file (references/update-templates.md) which is appropriate, but the bundle doesn't include it. The main file itself is quite long (~300+ lines) with substantial inline content (templates, failure patterns, cadence design) that could be split into reference files. The structure is good with clear headers, but the volume of inline content works against progressive disclosure. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8e70d03
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.