CtrlK
BlogDocsLog inGet started
Tessl Logo

communication

Use before sending or suppressing any Leader message to Workers, Manager, or Team Admin. Always use this skill for cross-room Matrix messages, @mention decisions, task assignment notifications, structured status reports, completion reports, blocker/revision messages, questions, requester updates, or when deciding whether a same-room reply is enough.

72

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-3

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

A well-structured, actionable routing skill with concrete message-tool examples and explicit validation checkpoints. Its main weakness is conciseness: the same routing rule is repeated across several sections and one protocol paragraph is a long run-on sentence.

Suggestions

State the same-room vs cross-room / `message`-tool rule once authoritatively (e.g. in Routing Gate) and have later sections reference it instead of restating it, cutting roughly 5 redundant repetitions.

Break the long NO_REPLY protocol sentence (line 51) into a short numbered list or bulleted conditions for faster scanning.

If the detailed requester-report routing table and NO_REPLY protocol grow further, consider moving them to a reference file to keep SKILL.md a lean overview.

DimensionReasoningScore

Conciseness

The core same-room/cross-room rule is restated roughly five times (Routing Gate #3, the 'Hard rule', Task Assignment Room, Same Room, and Cross-Room) and line 51 is an ~80-word run-on sentence, so it is mostly efficient but could be tightened; it avoids score 1 only because no space is spent explaining concepts Claude already knows — all content is domain-specific routing logic.

2 / 3

Actionability

It provides a copy-paste-ready `message` tool JSON call with a concrete `room:!roomid:domain` target, a concrete same-room @mention template with a real task ID, and a routing table, matching 'fully executable code/commands; specific examples; copy-paste ready'.

3 / 3

Workflow Clarity

The Routing Gate gives a numbered 1–3 decision sequence, and there are explicit validation checkpoints ("If the recorded requester is missing or does not match… stop and fix project metadata", the pre-send content check, and "If two rounds produce no new task… stop replying"), matching the clear-sequence-with-validation anchor.

3 / 3

Progressive Disclosure

The body is cohesive decision-time routing logic with no reference material to defer; it is well-organized into clearly-headed sections (Routing Gate, Task Assignment Room, Requester Reports, Same Room, Cross-Room, Rules) with easy navigation and no nested references, so the single-file structure is appropriate.

3 / 3

Total

11

/

12

Passed

Description

92%Weight 40%Scale 1-3

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, trigger-rich description with explicit 'Use before/Always use' guidance, third-person imperative voice, and concrete message-type enumeration. The main weakness is moderate conflict risk from the generic name and report-type overlap with project-management.

Suggestions

Tighten the report-type triggers (e.g. 'structured status reports, completion reports') to explicitly scope them to message routing/recipient decisions, clarifying the boundary with project-management which owns report content.

Consider a more distinctive skill name than 'communication' to reduce the chance of firing for unrelated messaging needs.

DimensionReasoningScore

Specificity

The description enumerates many concrete items — "cross-room Matrix messages, @mention decisions, task assignment notifications, structured status reports, completion reports, blocker/revision messages, questions, requester updates" — rather than vague language, matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

It answers both what (route/suppress Leader messages to Workers, Manager, or Team Admin) and when via explicit trigger clauses ("Use before sending or suppressing any Leader message…", "Always use this skill for… or when deciding whether a same-room reply is enough"), matching the explicit-trigger anchor.

3 / 3

Trigger Term Quality

It covers a broad set of natural domain trigger terms a user would say ("cross-room Matrix messages", "@mention decisions", "task assignment notifications", "blocker/revision messages", "requester updates", "same-room reply"), giving good coverage rather than a single keyword.

3 / 3

Distinctiveness Conflict Risk

The routing/recipient niche is fairly specific, but the generic skill name "communication" and the inclusion of report types ("structured status reports", "completion reports") that overlap conceptually with project-management leave some conflict risk, matching 'somewhat specific but could still overlap with similar skills'.

2 / 3

Total

11

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
agentscope-ai/AgentTeams
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.