CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

80%

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 ./manager/agent/team-leader-agent/skills/communication/SKILL.md
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 dense, highly actionable routing policy: concrete message formats, a routing table, explicit hard rules, and stop conditions leave little ambiguity about what to do. Its main cost is repetition — the same-room and delegate_task rules are each stated several times across sections — and one long prose paragraph that would be clearer as a sequence.

Suggestions

State the same-room/cross-room rule once in the Routing Gate as the hard rule, and have the Requester Reports, Same Room, and Cross-Room sections reference it instead of restating it in different words.

Consolidate the three separate statements of the `delegate_task` auto-notification rule into the Task Assignment Room section and briefly cross-reference it from Same Room and Cross-Room.

Restructure the Leader-DM `NO_REPLY` paragraph as a short ordered list of conditions (pre-assignment phase, allowed exceptions, post-assignment update) so the sequence is scannable instead of embedded in prose.

DimensionReasoningScore

Conciseness

No concept-explanation padding, but the same-room/cross-room rule ("do not call the `message` tool back into the current room") is restated in the Routing Gate hard rule, Requester Reports, Same Room, Cross-Room, and Rules sections, and the `delegate_task` auto-notification rule repeats across three sections. The repetition is noticeable rather than minor, fitting anchor 3 rather than 4.

3 / 5

Actionability

Provides copy-paste-ready artifacts: a concrete JSON `message` payload, an exact `@worker:domain` mention format, a Source→Target Room→Report To table, the `NO_REPLY` rule, and a concrete list of low-information pings to avoid. The instruction "Resolve the recipient Matrix ID and target room from `agt` CLI immediately before sending" lacks an example invocation, a minor gap that keeps it below anchor 5.

4 / 5

Workflow Clarity

The Routing Gate is an ordered 1-2-3 decision procedure with a hard rule, and Requester Reports includes explicit checkpoints ("stop and fix project metadata before reporting", mandatory requester notification, "If two rounds produce no new task, question, or decision, stop replying"). It falls below anchor 5 because the dense Leader-DM `NO_REPLY` paragraph buries its sequence conditions in prose rather than an explicit ordered flow.

4 / 5

Progressive Disclosure

Well-organized sections with no nested references and no bundle files to mis-route, and everything is at most one section deep. At roughly 93 lines with subsections like the Leader-DM `NO_REPLY` policy folded into Requester Reports, the structure is good but not the crisp overview-plus-signaled-references shape of anchor 5, and it exceeds the under-50-line simple-skill case.

4 / 5

Total

15

/

20

Passed

Description

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

A strong description: it states both the governing action and an unusually explicit, enumerated set of trigger scenarios in third person. The main weakness is that the skill's actual mechanism (room routing and same-room vs cross-room decisions) is implied through triggers rather than stated as capabilities, and a few broad terms soften distinctiveness.

DimensionReasoningScore

Specificity

Lists several concrete actions and trigger scenarios — "sending or suppressing any Leader message", "cross-room Matrix messages, @mention decisions, task assignment notifications, structured status reports" — though the skill's underlying capability (room routing rules) is only implied rather than stated as a verb list. It is above anchor 3 because more than 1-2 concrete actions are named, but short of anchor 5's comprehensive what-coverage.

4 / 5

Completeness

Explicitly answers both what ("Use before sending or suppressing any Leader message to Workers, Manager, or Team Admin") and when ("Always use this skill for cross-room Matrix messages... or when deciding whether a same-room reply is enough") with an enumerated list of concrete trigger phrases. It matches anchor 5; anchor 4 would require the when-clause to be less explicit or specific than it is.

5 / 5

Trigger Term Quality

Good natural keyword coverage for this domain: "message", "@mention", "task assignment", "status reports", "completion reports", "requester updates", "same-room reply". A few natural variants (e.g., "notify", "ping", "reply routing") are missing, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

Role-specific terms ("Leader message", "Workers, Manager, or Team Admin", "cross-room Matrix") carve a clear niche with minor overlap risk. Generic terms like "questions" and "requester updates" could plausibly trigger other communication-related skills, so it does not fully match anchor 5.

4 / 5

Total

17

/

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

agentscope-ai/AgentTeams

Path

manager/agent/team-leader-agent/skills/communication/SKILL.md

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.