CtrlK
BlogDocsLog inGet started
Tessl Logo

internal-comms

Write internal communications such as status reports, leadership updates, 3P updates, newsletters, FAQs, incident reports, and project updates using repeatable internal formats.

52

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/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 SKILL.md body is a well-written, concise dispatcher with a sensible workflow and fallback for unmatched communication types, but it delegates all substantive guidance to four examples/ files that are absent from the bundle. As shipped, the skill tells Claude exactly which file to open and then fails at that step, leaving it with no formatting, tone, or content instructions at all.

Suggestions

Ship the four examples/ guideline files (3p-updates.md, company-newsletter.md, faq-answers.md, general-comms.md) in the bundle so the dispatch workflow is actually executable, or inline a minimal format skeleton per communication type if the files are not distributed with the skill.

Extend the fallback guidance beyond unmatched types: instruct Claude what to do when a referenced guideline file is missing (e.g., fall back to general-comms.md conventions or state the standard 3P/status-report structure directly).

Remove the duplicated communication-type list in 'When to use this skill' (it repeats the frontmatter description verbatim) and instead merge it with the Keywords section into a single trigger block to save tokens.

DimensionReasoningScore

Conciseness

The body is lean with no concept over-explanation ('To write any internal communication: 1. Identify the communication type...'), but the 'When to use this skill' section re-lists all seven communication types already enumerated in the frontmatter description — a minor duplication that could be trimmed.

4 / 5

Actionability

The dispatch mapping is concrete (specific filenames like 'examples/3p-updates.md - For Progress/Plans/Problems team updates'), but the actual executable guidance (formatting, tone, content gathering) is delegated to 'Follow the specific instructions in that file' — and none of the four referenced examples/ files exist in the bundle, so the skill's core steps cannot be executed as shipped.

2 / 5

Workflow Clarity

A clear three-step sequence ('1. Identify the communication type... 2. Load the appropriate guideline file... 3. Follow the specific instructions') with an explicit fallback for unmatched types ('ask for clarification or more context'). Not a destructive or batch operation, so no validation checkpoint is required; the only gap is that step 2 has no fallback when a guideline file is missing.

4 / 5

Progressive Disclosure

The dispatcher pattern is structurally sound — one-level-deep, clearly labeled references ('examples/3p-updates.md', 'examples/company-newsletter.md', 'examples/faq-answers.md', 'examples/general-comms.md') — but verification shows none of these files exist in the bundle (no examples/, references/, scripts/, or assets/ directories), so the promised navigation targets are all broken.

2 / 5

Total

12

/

20

Passed

Description

66%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, concrete description that names the domain and enumerates specific deliverable types with natural trigger phrases, clearly distinguishable from adjacent skills. Its main defect is the missing 'when to use' guidance: without a 'Use when...' clause, triggering relies on users naming a communication type outright.

Suggestions

Append an explicit trigger clause, e.g.: 'Use when the user asks for a status update, 3P report, company newsletter, FAQ response, or any internal announcement.'

Fold the body's Keywords section synonyms ('weekly update', 'company comms', 'common questions') into the description itself so natural variations trigger from the description alone.

Clarify 'repeatable internal formats' with one concrete hook, e.g. 'following fixed templates per communication type', to make the method less abstract.

DimensionReasoningScore

Specificity

The description enumerates seven concrete deliverable types ('status reports, leadership updates, 3P updates, newsletters, FAQs, incident reports, and project updates') with a stated method ('using repeatable internal formats'), but relies on a single action verb ('Write') and the slightly abstract 'repeatable internal formats' — not the multiple distinct concrete actions of the 5 anchor, yet far more specific than the 1-2 actions of the 3 anchor.

4 / 5

Completeness

The 'what' is clearly answered (writing named internal-communication types with repeatable formats), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines — it is not score 4 because 'when' is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Good natural-phrase coverage ('status reports', 'newsletters', 'FAQs', 'incident reports') that users would plausibly say, but common variations like 'weekly update', 'team update', 'comms', and '3PP' appear only in the body's Keywords section, not the description itself.

4 / 5

Distinctiveness Conflict Risk

'Internal communications' carves a recognizable niche with fairly distinct triggers (3P updates, incident reports, company newsletters), but 'status reports', 'project updates', and 'FAQs' have minor overlap risk with general writing or documentation skills.

4 / 5

Total

15

/

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
administrakt0r/AI-Agents-Safe-Coding-Skills
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.