CtrlK
BlogDocsLog inGet started
Tessl Logo

effective-comms

Router for the "effective comms" trigger. Decides whether a communication needs `/comms-prep`, `/comms-review`, or no gate yet, then performs that action.

64

Quality

75%

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

Quality

Content

92%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 tightly written decision router: a short question checklist feeds an unambiguous first-match table, with a clear boundary statement that it delegates all rules to the gate skills. Structure and conciseness are strong; the only mild weakness is that execution relies on the sibling gate skills rather than self-contained steps.

DimensionReasoningScore

Conciseness

Lean and efficient: a one-line intro, four diagnostic questions, a decision table, and a two-line boundary note, with no padding and no explanation of concepts Claude already knows; every token earns its place.

5 / 5

Actionability

The decision table maps each state to a specific action ('Write it', 'Run /comms-prep', 'Run /comms-review', 'Deliver the draft') with a clear first-match rule; minor gap because actual execution depends on the gate skills' own behavior rather than fully self-contained steps.

4 / 5

Workflow Clarity

The process is unambiguous: answer four questions, then take the first matching table row; as a single-purpose router with no destructive or batch operation, the simple-skill exception applies and the decision flow needs no validation checkpoints.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external bundle files (rules live in the gate skills), and well-organized into heading, questions, table, and closing note; sibling-skill references (/comms-prep, /comms-review) are one level deep and clearly signaled.

5 / 5

Total

19

/

20

Passed

Description

58%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 states what the skill does and names its concrete routing targets, but omits any explicit 'Use when...' trigger guidance and leans on internal trigger names rather than natural user phrases, capping completeness and trigger-term quality.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger phrases users would actually say (e.g., 'Use when deciding whether a message or reply needs drafting help or review before sending').

Replace reliance on the internal trigger name 'effective comms' with natural synonyms a user would utter (reply, message, draft, send, review) to broaden trigger-term coverage.

Tighten 'then performs that action' to name the concrete follow-through so the action list is comprehensive rather than generic.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions: it 'decides whether a communication needs /comms-prep, /comms-review, or no gate yet, then performs that action', listing three explicit routing outcomes plus the perform step. Not a 5 because 'performs that action' is generic and the actions are skill invocations rather than fully enumerated operations.

4 / 5

Completeness

Provides a clear 'what' (router that decides among three gates and acts) but no explicit 'when' / 'Use when...' clause; the trigger is only weakly implied by 'effective comms' trigger, so per the missing-trigger-guidance cap it stays at 3.

3 / 5

Trigger Term Quality

Contains relevant keywords ('communication', 'effective comms') but relies on the skill's own trigger name and slash-command identifiers rather than natural user phrases like 'draft this reply' or 'is this ready to send'; common synonyms and variations are missing.

3 / 5

Distinctiveness Conflict Risk

Has a clear niche as a router over two specifically named sibling skills (/comms-prep, /comms-review), keeping conflict risk low; minor overlap risk exists with those gate skills themselves and with general writing skills.

4 / 5

Total

14

/

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
tollens-ai/effective-comms-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.