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.

59

Quality

68%

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

71%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 a well-organized, concise dispatch skill with a clear workflow, but its progressive disclosure is undermined by referenced example files that are absent from the bundle. Shipping the missing examples/ files would resolve the main weakness.

Suggestions

Include the referenced examples/ directory (3p-updates.md, company-newsletter.md, faq-answers.md, general-comms.md) in the bundle so the dispatched-to guideline files actually exist.

Remove the redundancy between the "When to use" type list and the "How to use" examples list, or cross-reference one from the other.

Add a brief note on what to do when a request matches multiple communication types, to close the small workflow-clarity gap.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence without explaining basic concepts, with only minor redundancy between the "When to use" type list and the "How to use" examples list.

4 / 5

Actionability

It gives concrete, executable steps with specific file paths to load (e.g. examples/3p-updates.md) and a clear fallback, though the substantive formatting guidance lives in the referenced files rather than inline.

4 / 5

Workflow Clarity

A clear 3-step dispatch sequence (identify type, load guideline file, follow its instructions) with a fallback for unmatched types; this is not a destructive or batch operation so the validation cap does not apply.

4 / 5

Progressive Disclosure

The overview cleanly dispatches one level deep to four example files, which is ideal structure, but the referenced examples/ directory does not exist in the bundle, so the navigation is broken and Claude cannot actually load the guideline files.

3 / 5

Total

15

/

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.

The description clearly enumerates concrete internal-communication types and stays in third person, but it omits an explicit "Use when..." trigger clause, which caps its completeness. Trigger-term coverage is good but could add common synonyms present in the body.

Suggestions

Add an explicit "Use when..." clause (e.g., "Use when writing internal updates, newsletters, FAQs, or incident reports") to lift completeness above 3.

Fold natural synonyms from the body's Keywords section ("weekly update," "company comms") into the description for fuller trigger-term coverage.

Specify the per-type action (e.g., "draft," "format," "assemble") rather than the single verb "Write" to push specificity toward 5.

DimensionReasoningScore

Specificity

Lists seven concrete communication types (status reports, 3P updates, newsletters, FAQs, incident reports, etc.), giving specific scope rather than vague language, but relies on a single action verb "Write" with no per-type action detail.

4 / 5

Completeness

The "what" is clear and concrete, but there is no explicit "Use when..." trigger clause; per the rubric guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Includes natural terms users would say ("status reports," "3P updates," "newsletters," "FAQs," "incident reports"), with good coverage though some synonyms like "weekly update" and "company comms" appear only in the body, not the description.

4 / 5

Distinctiveness Conflict Risk

The "internal communications" niche with distinctive types like 3P updates and incident reports is mostly distinct from other writing skills, with only minor overlap risk.

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.

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