CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

teamharness-roomflow

Use for TeamHarness room classification and Matrix task-room setup: roomflow describe_room, roomflow create_task_room, source/requester room vs task room detection, project-scoped task-room reuse, and invite handling. Do not use for projectflow, taskflow, or message delivery.

Quality

91%

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

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

A tight, well-structured instruction-only skill body: lean prose, concrete tool names and parameter guidance, and a clear classify-then-create workflow with guard rails. The remaining gaps are a worked invocation example and a validation checkpoint on the created/reused room.

Suggestions

Add one short example invocation of `roomflow create_task_room` (projectId plus source metadata) so the call syntax and argument shape are copy-paste ready rather than inferred.

Add a validation step after room creation, e.g. confirm the returned room name normalizes to `TASK:<projectId>` and route errors back to describe_room when classification is ambiguous.

DimensionReasoningScore

Conciseness

The body is lean and operational throughout: "Call `roomflow describe_room` when a Matrix room's purpose is unclear", "Pass a stable `projectId`", "Do not infer room purpose from joined-room IDs alone". There is no explanation of what Matrix or DingTalk are, no padding, and every sentence directs action — matching "every token earns its place".

5 / 5

Actionability

Concrete, actionable guidance for an instruction-only skill: it names the exact tools and their inputs — "Pass a stable `projectId`", "Pass the current source metadata exactly as received, such as DingTalk `sourceRoomId` and `sender`", "Pass the complete Matrix user IDs for Workers" — and gives a machine-checkable classification rule ("room name starts with `TASK:<projectId>`"). It falls short of anchor 5 because no complete invocation example (a full tool-call or command block) is ever shown, leaving the call syntax and argument shape implicit.

4 / 5

Workflow Clarity

The sequence is clear and ordered: (1) classify the room via describe_room with explicit criteria, (2) from a requester room call create_task_room before creating project/task state, (3) use the returned room for handoff and completion reports, with guard rails like "Do not use source room or sender identity to decide task-room reuse" serving as checkpoints. It is not a 5 because there is no validation step on the outcome — e.g., confirm the returned room name matches `TASK:<projectId>` or what to do when classification is ambiguous. The destructive/batch cap does not apply since room creation is neither.

4 / 5

Progressive Disclosure

The skill is a single ~40-line SKILL.md with no references/, scripts/, or assets/ directories and no external reference needs. Per the rubric guideline that skills under 50 lines with no need for external references score 5 with well-organized sections, the three clearly headed sections ("Describe Room", "Create Or Reuse Task Room") with the short intro qualify — everything is appropriately in one place and easy to navigate.

5 / 5

Total

18

/

20

Passed

Description

92%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: explicit trigger clause, named tool subcommands, and an explicit exclusion list for neighboring skills. The only gap is that most trigger terms lean on tool jargon rather than natural user synonyms.

DimensionReasoningScore

Specificity

The description lists multiple concrete, named actions — "roomflow describe_room, roomflow create_task_room, source/requester room vs task room detection, project-scoped task-room reuse, and invite handling" — including exact tool subcommands. This matches the anchor 'lists multiple specific concrete actions; comprehensive coverage'; there are no vague filler phrases, and a neighboring anchor-4 example ("Extracts text from PDF files, fills forms, converts pages to images") covers fewer named actions.

5 / 5

Completeness

It explicitly answers both questions: the what is the enumerated capability list ("room classification and Matrix task-room setup: roomflow describe_room, roomflow create_task_room, ...") and the when is an explicit "Use for TeamHarness room classification and Matrix task-room setup" trigger clause, matching the anchor-5 example pattern ("Extract text and tables from PDF files... Use when working with PDF files..."). It is not score 4 territory because the 'when' is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "room classification", "task room", "Matrix task-room setup", "create task room", "room detection", "invite handling" — phrases a user needing this skill would plausibly say. It falls short of the anchor-5 "comprehensive coverage of natural terms including synonyms" because most terms are tool-flavored jargon ("roomflow describe_room") and natural synonyms like "channel" or "workspace" for the requester room are absent.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (TeamHarness/Matrix room classification and task-room setup) and adds an explicit negative boundary — "Do not use for projectflow, taskflow, or message delivery" — which actively disambiguates against the most likely competing skills. Minimal conflict risk, matching the anchor 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

19

/

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

plugins/teamharness/skills/team/roomflow/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.