CtrlK
BlogDocsLog inGet started
Tessl Logo

internal-comms

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

89

1.37x
Quality

63%

Does it follow best practices?

Impact

92%

1.37x

Average score across 10 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/anthropic-internal-comms/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is well-structured as a concise router with a clear decision flow and fallback, but it is critically undermined by referencing four examples/ guideline files that do not exist anywhere in the bundle. What reads as good progressive disclosure is, in practice, a routing table pointing at nothing, which caps both actionability and progressive_disclosure at the low end.

Suggestions

Add the missing examples/ guideline files (3p-updates.md, company-newsletter.md, faq-answers.md, general-comms.md) so the core 'load the appropriate guideline file' step is actually executable — this is the single highest-impact fix.

Trim the duplicated communication-type list and Keywords section, or fold them into one section, since the description already enumerates the same types.

Add brief disambiguation guidance for requests that could match multiple types (e.g., a status report vs. a 3P update) so the 'identify the communication type' step is unambiguous.

DimensionReasoningScore

Conciseness

The body is a lean router: identify type, load one of four named guideline files, follow it, with an explicit fallback — matching anchor 4's 'efficient; minor instances that could be trimmed'. Not 5 because the 'When to use' bullet list and 'Keywords' section largely duplicate the communication-type list already enumerated in the description.

4 / 5

Actionability

The steps are concrete in form (named files with per-file purposes), but the core instruction — 'Load the appropriate guideline file from the `examples/` directory' — cannot be executed because no examples/ directory or guideline files exist in the bundle, leaving only high-level hints that dead-end. This matches anchor 2 ('missing the specific steps to execute') rather than 3, since the missing files remove the actual executable content, not just key details.

2 / 5

Workflow Clarity

A clear three-step sequence ('Identify the communication type' → 'Load the appropriate guideline file' → 'Follow the specific instructions') with an explicit fallback checkpoint ('If the communication type doesn't match... ask for clarification') matches anchor 4. Not 5 because the load step cannot actually complete given the missing bundle files, and 'identify the communication type from the request' offers no disambiguation guidance for mixed-type requests.

4 / 5

Progressive Disclosure

The references are clearly signaled and one level deep in form (each examples/ file named with its purpose), but scored against the actual bundle structure, zero bundle files exist — the entire detail layer is missing and navigation is impossible. This matches anchor 2's 'minimal structure' (what actually exists is a single file with no supporting materials) rather than 3, where references are present but imperfect.

2 / 5

Total

12

/

20

Passed

Description

73%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 that clearly defines a distinct niche and provides an explicit 'use when' clause with a concrete list of trigger communication types. Its main flaws are the first-person voice ("help me write", "my company"), which the rubric penalizes, and reliance on a single action verb with output-type enumeration rather than multiple distinct capabilities.

Suggestions

Rewrite in third person (e.g., 'Writes internal communications using preferred company formats...') to remove the first-person penalty and improve clarity for any user, not just the author.

Add natural trigger variations such as 'weekly updates', 'team updates', or 'all-hands announcements' to broaden keyword coverage toward the top anchor.

DimensionReasoningScore

Specificity

The description names the domain and a comprehensive list of output types ("status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates") but only one action verb ("write"), matching anchor 3 rather than 4's 'several specific actions'. Per the rubric guideline, the first-person phrasing ("to help me write", "my company likes to use") reduces the score by 1, from 3 to 2.

2 / 5

Completeness

It explicitly answers 'what' ("A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use") and 'when' with concrete triggers ("Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates...)"). This matches anchor 5, which requires both what and when with concrete trigger phrases; anchor 4's weaker 'when' example is less explicit than this parenthetical trigger list.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are well covered ("status reports", "leadership updates", "3P updates", "company newsletters", "incident reports"), matching anchor 4's 'good keyword coverage; a few natural terms missing'. Not 5 because common variations like "weekly update", "team update", or "all-hands" are absent.

4 / 5

Distinctiveness Conflict Risk

The internal-communications niche is mostly distinct, with distinctive triggers like "3P updates", "company newsletters", and "incident reports" matching anchor 4's 'minor overlap risk with closely related skills'. Not 5 because generic terms like "FAQs" and "status reports" could overlap with general writing or documentation skills.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
boisenoise/skills-collections
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.