CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

worker-management

Use when admin requests hand-creating or resetting a Worker, starting/stopping a Worker, managing Worker skills, enabling peer mentions, or opening a QwenPaw console. Use agentteams-find-worker only as a helper for Nacos-backed market import or when task assignment needs you to discover a suitable Worker.

Quality

84%

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.

An operationally excellent skill body: executable commands with an inline SOUL template, confirmation gates on every destructive operation, and a best-practice operation table that keeps the overview lean while all detail lives one reference level deep. The only flaw is mild redundancy — the runtime fallback and the Local/controller-managed point are each repeated — which costs a little token efficiency.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational specifics (name regex with Matrix localpart rationale, runtime table, env-var fallback, gotchas) and explains nothing Claude already knows, but the runtime fallback behavior and the 'Local means controller-managed' point are each stated twice, matching anchor 4's 'minor instances of over-explanation that could be trimmed' rather than anchor 5.

4 / 5

Actionability

Guidance is fully executable: a copy-paste-ready `agt create worker --no-wait --soul "..."` command with an inline SOUL template, `agt get workers -o json` for phase polling, a complete `update-worker-config.sh --name --runtime [--model] [--skills] [--mcp-servers]` invocation, and `agt apply -f` for resource tuning — anchor 5's 'copy-paste ready commands covering the common cases'.

5 / 5

Workflow Clarity

Destructive flows carry real checkpoints: the four-input admin confirmation before create, 'Always confirm with admin first' before runtime switches, confirm-not-mid-task before resource changes, polling to `phase=Running`, and a stop-after-two-identical-outputs anti-loop rule — anchor 4 rather than 5 because per-operation error-recovery loops are deferred to the reference docs and some checkpoints (e.g. post-create greeting order) are only implied here.

4 / 5

Progressive Disclosure

The Operation Reference table maps each admin intent to exactly one reference doc and script, all 11 referenced paths exist in the bundle, references are exactly one level deep (no doc-to-doc nesting), and every bundle file not cited in SKILL.md is reachable from a reference doc or script — a clear overview with well-signaled one-level-deep references and easy navigation.

5 / 5

Total

18

/

20

Passed

Description

73%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, trigger-oriented description with concrete enumerated actions, explicit use-when guidance, and unusually good boundary disambiguation against a sibling skill. Its weaknesses are the second-person phrasing that costs it a specificity point, the absence of runtime switching among the triggers, and a missing standalone capability statement.

Suggestions

Rewrite the second clause in third person (e.g. '...or when task assignment requires discovering a suitable Worker') to remove the second-person voice and recover the specificity penalty.

Add the missing capability/triggers for runtime switching and worker deletion (e.g. 'switching a Worker's runtime (openclaw/copaw/qwenpaw/hermes/openhuman) or deleting a Worker') to close the coverage gap.

Lead with a short third-person capability sentence (e.g. 'Creates, resets, and manages the lifecycle of Worker agents...') before the Use-when clause so the 'what' is explicit rather than inferred from the trigger list.

DimensionReasoningScore

Specificity

The description enumerates concrete actions ("hand-creating or resetting a Worker, starting/stopping a Worker, managing Worker skills, enabling peer mentions, or opening a QwenPaw console") which would fit anchor 4 with only a minor coverage gap (runtime switching is omitted), but it uses second person ("when task assignment needs you to discover a suitable Worker"), which the rubric penalizes by reducing specificity by 1.

3 / 5

Completeness

An explicit 'Use when' clause with concrete triggers answers 'when' maximally, and the enumerated requests convey 'what', but the 'what' is embedded in the trigger list rather than stated as a separate capability sentence (e.g. 'Manages Worker lifecycle...'), placing it just below anchor 5 and clearly above anchor 3's missing-when case.

4 / 5

Trigger Term Quality

Natural admin phrasings are well covered ("creating", "resetting", "starting/stopping", "managing Worker skills", "enabling peer mentions", "opening a QwenPaw console"), matching anchor 4's 'good keyword coverage; a few natural terms missing' — synonyms like restart, delete, or switch/migrate runtime are absent, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear Worker-administration niche and explicitly disambiguates the neighboring skill ("Use agentteams-find-worker only as a helper for Nacos-backed market import or when task assignment needs you to discover a suitable Worker"), giving distinct triggers with minimal conflict risk.

5 / 5

Total

16

/

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/skills/worker-management/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.