CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

internal-comms

Use when a Head of People Ops, BizOps lead, or Internal Communications owner needs to draft and sequence an internal-only change-management communication — a re-org announcement, a tool rollout, a policy change, a leadership transition, a layoff, an acquisition close, or an internal product launch — and the audience is employees (not customers). Pairs Prosci ADKAR and Kotter's 8-step change model with deterministic stdlib-only Python tools to produce a sequenced touchpoint calendar, a Kotter-compliant primary announcement, an audience-segmented FAQ, and manager cascade talking points; industry-tuned via --profile {tech-startup, scaleup, enterprise, public-company, non-profit}. Triggers on "all-hands announcement", "change comms", "rollout comms", "re-org announcement", "manager talking points", "layoff comms".

66

Quality

83%

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

67%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, genuinely actionable skill body: a deterministic five-step workflow with tool-enforced validations and a do-not-send gate, verified script flags, and real one-level-deep references. The main costs are token redundancy (the 5–7 touchpoint stat and related canon repeated across five sections) and two sections of inline detail that belong in the reference files.

Suggestions

State the '5–7 touchpoint floor' and manager-first canon once (e.g., in Workflow or References) and cross-reference it elsewhere; it currently appears in Purpose, When to use, Scripts, Anti-patterns, and forcing-question 3, which is pure token overhead.

Add copy-paste example invocations for change_announcement_builder.py and comms_calendar_builder.py (e.g., python3 scripts/comms_calendar_builder.py --input brief.json --output markdown) and make the Quick example's path relative to the skill root instead of the fixed 'business-operations/skills/internal-comms' location.

Move the full forcing-question library (questions + recommended answers + canon citations) into references/ (e.g., references/forcing_questions.md) and keep a one-line pointer plus the 'one at a time, never bundled' rule in SKILL.md.

DimensionReasoningScore

Conciseness

The same canonical stat is restated five times — "Prosci research shows 5–7 touchpoints are the floor" (Purpose), "assess whether 5–7 touchpoints are scheduled" (When to use), "Prosci's documented floor for behavioral change is 5–7" (Scripts), "Prosci floor is 5–7" (Anti-patterns), "minimum 5, target 7" (forcing-question 3) — and the manager-trust and magnitude-honesty points are likewise each repeated across 3–4 sections. That is more than the 'minor instances of over-explanation' of anchor 4, fitting anchor 3 ('could be tightened'), though the content is domain-specific with no generic-concept padding, so it is not the severe verbosity of anchor 2.

3 / 5

Actionability

Concrete executable command ("cd business-operations/skills/internal-comms && python3 scripts/comms_template_filler.py --sample"), specific script flags verified in the actual argparse code (--input, --output, --sample, --profile with the exact profile enum), and concrete recommended answers per forcing question. It misses anchor 5 because only one of the three scripts has an example invocation and the example's cd path assumes a fixed install location rather than being copy-paste ready relative to the skill.

4 / 5

Workflow Clarity

"Five-step deterministic flow. Follow in order." gives a clear numbered sequence with concrete per-step commands, and step 5 is an explicit pre-publish validation gate ("any one of them is a 'do not send' signal") with tool-enforced validations in step 2. It falls short of anchor 5 because the error-recovery feedback loop is implicit — the sweep says what fails but never says what to do next (fix which artifact, re-run which script) — though it is clearly above anchor 3, where checkpoints are merely listed without an explicit gate.

4 / 5

Progressive Disclosure

References are one level deep, well-signaled with per-file descriptions, and all six referenced paths (3 references, 3 scripts, 1 asset template) verified to exist; each script section documents purpose and flags rather than inlining the code. Minor gaps keep it below anchor 5: the ~30-line forcing-question library with full recommended answers and citations, and the anti-pattern list that previews the references file's 8 anti-patterns, are detail that arguably belongs in a reference file with a pointer from the overview.

4 / 5

Total

15

/

20

Passed

Description

92%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: concrete deliverables, explicit role-based 'Use when' guidance plus a dedicated trigger list, and a clear internal-vs-external niche boundary. The only weakness is moderate synonym coverage in the trigger list (e.g., "town hall announcement", "internal FAQ"), which caps trigger_term_quality at 4.

DimensionReasoningScore

Specificity

Lists multiple concrete deliverables — "produce a sequenced touchpoint calendar, a Kotter-compliant primary announcement, an audience-segmented FAQ, and manager cascade talking points" — plus the concrete tuning mechanism "industry-tuned via --profile {tech-startup, scaleup, enterprise, public-company, non-profit}". This matches the anchor for comprehensive concrete-action coverage; it is well above anchor 4, which only requires 'several specific actions with minor gaps'. Voice is third person ("Pairs...", "produce...").

5 / 5

Completeness

Explicitly answers 'what' (pairs ADKAR and Kotter with deterministic tools to produce the four named artifacts) and 'when' ("Use when a Head of People Ops, BizOps lead, or Internal Communications owner needs to..." plus a dedicated "Triggers on..." clause with concrete trigger phrases). This is a direct match to the anchor-5 exemplar structure; anchor 4 ('when could be more explicit') clearly fits worse given two explicit trigger formulations.

5 / 5

Trigger Term Quality

Explicit triggers — "all-hands announcement", "change comms", "rollout comms", "re-org announcement", "manager talking points", "layoff comms" — are natural phrases a comms owner would actually say, plus event nouns in the body (layoff, acquisition close, policy change). It falls short of anchor 5 because common variations like "town hall announcement", "internal FAQ", or "org change announcement" are absent. Clearly above anchor 3 ('relevant keywords but missing common variations') is not the best fit since most core variations are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: the description disambiguates the audience ("the audience is employees (not customers)") and names an explicit role (Head of People Ops, BizOps lead, Internal Communications owner), so it will not fire for external marketing comms or general writing skills. Trigger phrases like "layoff comms" and "manager talking points" are domain-specific with minimal conflict risk, matching anchor 5.

5 / 5

Total

19

/

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

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

business-operations/skills/internal-comms/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.