CtrlK
BlogDocsLog inGet started
Tessl Logo

internal-comms-community

To write internal communications, use this skill for:

49

Quality

62%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/internal-comms-community/SKILL.md

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

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.

The body is a lean, well-organized router with a clear sequence and fallback, but it delegates 100% of the skill's substance to four examples/ files that are missing from the bundle, leaving dangling references and no actionable guidance on its own.

Suggestions

Ship the referenced guideline files — the bundle contains no examples/ directory, so examples/3p-updates.md, examples/company-newsletter.md, examples/faq-answers.md, and examples/general-comms.md are all dangling and the skill currently provides no content when loaded.

Add a minimal amount of substantive guidance inline in SKILL.md (e.g., a one-line skeleton of a 3P update or the core rules for each comm type) so the skill remains useful even if a guideline file is missing.

Clarify step 3 of the workflow — 'Follow the specific instructions in that file' is vacuous as written; state what following the file entails or fold its essential rules into the body.

DimensionReasoningScore

Conciseness

The body is ~35 lean lines that assume Claude's competence: it never explains what a newsletter or status report is, and maps each communication type to a guideline file with no padding, matching 'Lean and efficient; assumes Claude's competence; every token earns its place'. Not score 4 because there is no over-explanation or trimmable material anywhere in the body.

5 / 5

Actionability

The routing is concrete (specific file paths per type: 'examples/3p-updates.md', 'examples/company-newsletter.md', etc.), but the bundle contains no examples/ directory — the referenced files do not exist, and the body itself carries zero substantive writing guidance (no formatting, tone, or structure instructions). This matches 'Some concrete guidance but incomplete... missing key details': not score 4 because the guidance cannot actually be executed as bundled, and not score 2 because the type-to-file mapping and fallback instruction are genuinely specific.

3 / 5

Workflow Clarity

The three-step sequence (identify type, load guideline file, follow instructions) is clear and correctly ordered, with an explicit fallback ('ask for clarification or more context') serving as a checkpoint for unmatched types, matching 'Clear sequence with most checkpoints present; minor validation gaps'. Not score 5 because step 3 ('Follow the specific instructions in that file') is vacuous — the actual workflow substance is deferred entirely to files that are not present — and not score 3 because no destructive or batch operations are involved, so no validation loop is required.

4 / 5

Progressive Disclosure

As written the structure looks ideal (clear overview routing each type to a one-level-deep, well-signaled file with a general-comms fallback), but scoring against the actual bundle structure, none of the four referenced examples/ files exist — the entire disclosure chain is dangling and the skill delivers no content at all. This lands at 'Minimal structure' (score 2): the skill is a shell whose disclosed content is unreachable, far below score 4's 'most content is appropriately placed' since the referenced content is absent, though above score 1 because there is no monolithic text or multi-level nesting.

2 / 5

Total

14

/

20

Passed

Description

41%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 is a truncated, circular sentence: it names the niche but ends at a colon with the promised type list missing, and it contains essentially one generic keyword. Its saving grace is that "internal communications" is a reasonably distinct domain.

Suggestions

Complete the truncated sentence by enumerating the communication types directly in the description (e.g., 'Write 3P updates, company newsletters, FAQ responses, status reports, and incident reports. Use when the user asks for any internal communication or team update.'), since the colon currently dangles with no list in the description field.

Add natural trigger terms users would actually say — 'newsletter', 'weekly update', 'status report', '3P update', 'FAQ' — to the description itself rather than only in the body's Keywords section.

Replace the circular construction with a concrete 'what' (specific document types) plus a distinct 'when' clause so both halves answer their question independently.

DimensionReasoningScore

Specificity

The description names the domain ("internal communications") and a single generic action ("write"), matching the anchor 'Names the domain but actions are minimal or generic'. It is not score 1 because the domain is named and a task verb is present, and not score 3 because the concrete action list (3P updates, newsletters, FAQs, etc.) exists only in the body — the description field itself ends at a dangling colon with no enumerated actions.

2 / 5

Completeness

The sentence "To write internal communications, use this skill for:" is truncated mid-list — the colon promises an enumeration that never appears in the description, leaving the 'what' generic and the 'when' circular (use this skill when writing the thing this skill writes). An explicit trigger clause exists, so it is above score 2, but the dangling colon and circular trigger keep it below score 4's 'both what and when, when could be more explicit' standard, since the substance of both is missing.

3 / 5

Trigger Term Quality

The only keyword in the description is "internal communications" — a single generic term missing the natural phrases users would say (e.g., "newsletter", "weekly update", "status report", "3P update", "FAQ"), matching 'One or two generic keywords; missing the natural phrases users say'. Not score 3 because the synonym coverage (company newsletter, status reports, FAQs) that would qualify as 'some relevant keywords' is entirely absent from the description field.

2 / 5

Distinctiveness Conflict Risk

"internal communications" carves out a clear niche that is mostly distinct, with only minor overlap risk against general writing/email skills, matching 'Mostly distinct; minor overlap risk with closely related skills'. Not score 5 because a distinct niche alone is insufficient — the truncated description offers few distinct trigger phrases to separate it from generic writing skills, unlike the anchor's example with multiple concrete triggers.

4 / 5

Total

11

/

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.