CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

stakeholder-communication

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.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable instruction skill with concrete templates, examples, and a validated workflow. Its weaknesses are redundancy: four inline templates duplicate the reference file, and the core headline-first principle is repeated across multiple sections, inflating token cost without adding guidance.

Suggestions

Replace the four full inline templates (weekly update, executive review, bad news, decision request) with one compact exemplar plus a pointer to references/update-templates.md, which already contains annotated versions of all of them — this removes ~90 duplicated lines and sharpens progressive disclosure.

Consolidate the repeated headline-first guidance: state it once in Question 2 / the inverted pyramid and prune its restatements in workflow Step 2, 'What to avoid', and the failure patterns list.

Trim the 12-item failure patterns list to the highest-value items or merge overlapping ones (e.g., 'Optimistic projections' and 'Status: yellow' both cover dishonest status reporting).

DimensionReasoningScore

Conciseness

The body is mostly efficient — tight one-paragraph failure patterns, a compact tone table, and no padding explaining concepts Claude already knows — but it includes unnecessary redundancy: the headline-first principle is restated in at least four places (Q2, the inverted pyramid, workflow Step 2, 'What to avoid', and failure patterns), and the four inline templates (weekly update, executive review, bad news, decision request) duplicate templates 1, 5, 10, and 4 in references/update-templates.md nearly in full. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trim 4 anchor.

3 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: four copy-paste-ready templates with labeled fields, a concrete before/after so-what example ('We hit 80% of the milestone' → 'puts the launch one week behind plan'), an audience/tone/detail/length table, an explicit word-level cut list (adjectives, filler, hedging), and a bad-news structure with named sections. Specific examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced (define audience/purpose → draft headline → inverted pyramid → cut → verify request → check audience → send and follow up) with explicit validation checkpoints in Steps 5 and 6 ('Is the ask clear? Is it specific? Is the deadline named?' / 'Imagine the recipient reading') and a post-send feedback loop in Step 7 (watch for confused replies, follow up on stale asks). This is a writing skill, not a destructive/batch operation, so no validation cap applies; the checklist-style verification matches the 5 anchor.

5 / 5

Progressive Disclosure

Good structure overall: one clearly signaled one-level-deep reference ('references/update-templates.md: Ready-to-use templates... with annotated examples') that exists in the bundle, and framework/tone/failure-pattern content appropriately kept inline. The main organization gap is that ~90 lines of inline templates in the body substantially duplicate the annotated templates in the reference file, so content placement isn't fully clean — fits the 4 anchor ('most content is appropriately placed; minor organization gaps') rather than the clean-split 5, but better than the 3 anchor since the split is otherwise sensible.

4 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concrete scenario enumeration, an explicit 'Use this skill when' clause, and a rich trigger list with synonyms. The main softness is the generic lead capability phrase and a few missing natural trigger terms.

DimensionReasoningScore

Specificity

The lead phrase 'Communicate effectively with stakeholders' is generic, but the description enumerates several concrete activities — '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' — matching the 'lists several specific actions; minor gaps in coverage' anchor. Not 5 because the core capability statement lacks the multiple distinct concrete verbs of the top anchor; not 3 because far more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicitly answers 'what' ('Communicate effectively with stakeholders across functions and seniority levels', elaborated by the enumerated scenario types) and 'when' with a dedicated 'Use this skill when...' clause plus concrete trigger phrases and an additional trigger condition. Both parts are explicit with concrete triggers, matching the 5 anchor; the 4 anchor's caveat ('when' could be more explicit) does not apply.

5 / 5

Trigger Term Quality

'Triggers on stakeholder update, status report, executive summary, exec review, manage up, communicate bad news, project comms, status meeting, weekly update' gives good keyword coverage with natural synonyms (executive summary/exec review, status report/weekly update) plus the off-track condition. A few natural terms are still missing (e.g., leadership update, escalation, decision request, announcement), so it fits the 4 anchor rather than comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

Triggers like 'manage up', 'exec review', and 'status report' are specific to stakeholder communication, giving a mostly distinct niche. Minor overlap risk remains with closely related skills (incident comms, general writing/reporting) since the description itself carries no exclusion boundary — the boundary guidance lives only in the body. Fits the 4 anchor; not 5 because neighboring communication-type skills could still compete for generic terms like 'weekly update'.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

rampstackco/claude-skills

Path

skills/stakeholder-communication/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.