CtrlK
BlogDocsLog inGet started
Tessl Logo

internal-comms-community

To write internal communications, use this skill for:

42

Quality

43%

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/skills/internal-comms-community/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured routing skill that efficiently directs Claude to the appropriate guideline file based on communication type. Its main strength is conciseness and clear organization. Its main weakness is that all substantive guidance is deferred to external files that weren't provided for evaluation, making the skill itself a thin dispatcher with limited standalone actionability.

Suggestions

Add at least one inline example of a completed communication (e.g., a short 3P update) so the skill has standalone actionability even if guideline files fail to load.

Include a brief verification step in the workflow, such as 'Confirm the identified communication type with the user before loading the guideline file' or 'Review output against the guideline's tone and format requirements before presenting.'

DimensionReasoningScore

Conciseness

The content is lean and efficient. Every line serves a purpose—identifying communication types, mapping them to files, and providing a clear fallback. No unnecessary explanations of what internal communications are or how Claude should think about them.

5 / 5

Actionability

The skill provides a clear routing mechanism to guideline files, but the actual actionable content is entirely deferred to those files. The skill itself contains no concrete examples, templates, or executable guidance—it's essentially a dispatcher. Without the bundle files to verify, the actionability of the overall system is uncertain.

3 / 5

Workflow Clarity

The three-step workflow (identify type → load file → follow instructions) is clear and well-sequenced with a fallback for unmatched types. However, there are no validation checkpoints—e.g., confirming the communication type with the user before proceeding, or verifying the output meets the guideline's requirements. Since this is a non-destructive writing task, the lack of validation is less critical.

4 / 5

Progressive Disclosure

The skill appropriately delegates detailed instructions to separate files in the examples/ directory with clear one-level-deep references. However, no bundle files were provided to verify these references actually exist, and the references could be slightly better signaled (e.g., brief descriptions of what each file contains beyond just the type name).

4 / 5

Total

16

/

20

Passed

Description

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

This description is critically incomplete—it appears to be a truncated fragment ending with a colon and no content following it. It lacks any concrete actions, has minimal trigger terms, and provides no guidance on when Claude should select this skill. It would be nearly unusable for skill selection among multiple options.

Suggestions

Complete the description by listing specific actions such as 'Drafts company-wide announcements, team updates, policy change notices, and internal memos.'

Add an explicit 'Use when...' clause with natural trigger terms like 'internal email', 'company announcement', 'team memo', 'all-hands update', 'policy communication'.

Rewrite in third person active voice (e.g., 'Writes internal communications including...') and ensure the sentence is grammatically complete.

DimensionReasoningScore

Specificity

The description names a vague domain ('internal communications') but provides no concrete actions whatsoever—no mention of what it actually does (drafts emails, writes memos, creates announcements, etc.).

1 / 5

Completeness

The 'what' is extremely vague (no concrete actions described), and the 'when' clause is incomplete—it ends with 'use this skill for:' followed by nothing, making both dimensions essentially missing.

1 / 5

Trigger Term Quality

The phrase 'internal communications' is a relevant keyword, but it's the only one present. Missing natural terms users would say like 'memo', 'announcement', 'company email', 'all-hands', 'newsletter', etc.

2 / 5

Distinctiveness Conflict Risk

'Internal communications' is broad and could overlap with email writing skills, document drafting skills, or general writing skills. Without specific actions or triggers, conflict risk is high.

2 / 5

Total

6

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

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.