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".

67

Quality

84%

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

The canonical home for this skill is internal-comms in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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, domain-competent skill body with a deterministic five-step workflow and genuine validation checkpoints, undermined by two issues: verbatim-level redundancy between 'When NOT to use'/'Distinct from' and between the Workflow and Scripts sections, and a bundle that omits every file the body depends on. The guidance itself is concrete and framework-anchored rather than fluffy.

Suggestions

Merge 'When NOT to use' with 'Distinct from' (they cover the same sibling skills twice), and let the Workflow steps carry tool behavior so the Scripts section only documents flags/outputs — this alone would remove ~30 lines of duplication.

Ship the referenced bundle files (scripts/comms_template_filler.py, scripts/change_announcement_builder.py, scripts/comms_calendar_builder.py, references/announcement_anti_patterns.md, and the canon/asset files) or inline minimal versions; the workflow's step 5 and the Quick example currently point at files that don't exist.

Close the feedback loop in step 5: state what to do when the anti-pattern sweep fails (e.g., 'regenerate with change_announcement_builder.py at the corrected magnitude and re-run the sweep before publishing').

DimensionReasoningScore

Conciseness

The body has real duplication beyond 'minor trim' level: 'When NOT to use' and 'Distinct from' list the same sibling skills (marketing-skill, c-level-advisor/change-management, c-level-advisor/internal-narrative) with overlapping rationale, and the 'Scripts' section re-describes the three tools already characterized in Workflow steps 2–4. The Purpose section's four failure modes are also partly rhetorical. It stays above a 2 because nothing explains basics Claude already knows — the ADKAR/Kotter content is applied skill-specifically (magnitude/tone rules, touchpoint floors), not textbook summary.

3 / 5

Actionability

Concrete and mostly executable: exact script names with flags ('--profile <industry>', '--input <json>', '--output {markdown,json}', '--sample'), a runnable Quick example command, and a precise 8-item anti-pattern checklist. Not a 5 because the intake step defers entirely to 'assets/comms_brief_template.md and its JSON skeleton' with no inline example, and the example command's cd path ('business-operations/skills/internal-comms') assumes a repo layout the bundle doesn't define.

4 / 5

Workflow Clarity

'Five-step deterministic flow. Follow in order.' gives a clear sequence, each step names its tool, and steps 2–5 embed validation (magnitude/tone checks, gap surfacing, the anti-pattern sweep: 'The 8 anti-patterns listed there are non-negotiable; any one of them is a "do not send" signal'). Not a 5 because there is no explicit error-recovery branch: what to do when the anti-pattern sweep fails or a gap is surfaced (re-run which tool with what change) is left implicit. This is not a destructive/batch operation, so the workflow-clarity cap of 3 does not apply.

4 / 5

Progressive Disclosure

The markdown is well-sectioned and references are clearly signaled one level deep ('references/announcement_anti_patterns.md', three scripts, one asset template), but the bundle contains no references/, scripts/, or assets/ directories — all seven referenced paths are dead. Scored against the actual bundle structure per the judging guidelines, the disclosure chain is broken: the anti-pattern sweep, the JSON skeleton, and the runnable example all depend on files that do not ship with the skill.

3 / 5

Total

14

/

20

Passed

Description

100%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.

An exemplary description: concrete artifact list, explicit role-scoped 'Use when' clause, natural trigger phrases, and an explicit internal-vs-customer boundary. Voice is third-person/impersonal ('Use when a Head of People Ops... needs to'), so no voice penalty applies. The length is dense but every clause adds a capability, trigger, or boundary — not padding.

DimensionReasoningScore

Specificity

Lists multiple concrete deliverables — 'a sequenced touchpoint calendar, a Kotter-compliant primary announcement, an audience-segmented FAQ, and manager cascade talking points' — plus the mechanism ('deterministic stdlib-only Python tools') and tuning options ('--profile {tech-startup, scaleup, enterprise, public-company, non-profit}'). This matches the anchor 'lists multiple specific concrete actions; comprehensive coverage'; a 4 would require minor gaps in coverage, but all four artifacts of the package are named.

5 / 5

Completeness

Explicitly answers both: WHAT — 'produce a sequenced touchpoint calendar, a Kotter-compliant primary announcement, an audience-segmented FAQ, and manager cascade talking points' — and WHEN — 'Use when a Head of People Ops, BizOps lead, or Internal Communications owner needs to draft and sequence an internal-only change-management communication', reinforced by the 'Triggers on' clause. Matches the anchor 5 example structure exactly; anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Explicit natural trigger phrases — '"all-hands announcement", "change comms", "rollout comms", "re-org announcement", "manager talking points", "layoff comms"' — plus a full enumeration of event types ('a re-org announcement, a tool rollout, a policy change, a leadership transition, a layoff, an acquisition close, or an internal product launch'). These are the phrases a comms owner would naturally say; coverage is comprehensive across the domain rather than merely 'good with a few missing' (anchor 4).

5 / 5

Distinctiveness Conflict Risk

Clear niche with an explicit boundary — 'internal-only change-management communication... the audience is employees (not customers)' — which separates it from customer-facing launch comms. Triggers are domain-specific ('layoff comms', 'manager talking points') and unlikely to fire a generic or external-comms skill; minimal conflict risk.

5 / 5

Total

20

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 10 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/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.