CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

task-management

Use when admin gives a task to delegate to a Worker, when a Worker reports task completion, when managing recurring scheduled tasks, or when you need to check worker availability.

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 ./manager/agent/skills/task-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 exemplary overview-style body: lean, dense with non-obvious operational rules, and a situation-to-reference routing table that keeps the context footprint tiny. The weaknesses are the absence of any sequenced workflow or validation checkpoints within the body itself (deferred to references) and minor second-level reference hops.

Suggestions

Add a short numbered end-to-end sequence (select worker → register task in state.json → push spec to MinIO → notify → pull results on completion) so the core flow is visible without loading a reference.

Include one inline example invocation of `scripts/manage-state.sh` and `scripts/find-worker.sh` so the most common actions are executable from the body alone.

Flatten the second-level reference hops (e.g., have the routing table list `references/infinite-tasks.md` directly instead of reaching it via finite-tasks.md, and verify the cross-skill HEARTBEAT.md/team-management paths resolve).

DimensionReasoningScore

Conciseness

Every one of the ~30 lines is system-specific operational knowledge Claude could not know elsewhere: "Always use `manage-state.sh`... never edit manually with jq", "Never @mention a Worker after recording infinite task execution — this creates a rapid-fire loop... that burns tokens". There is no filler, no explanation of concepts Claude already knows, and each gotcha pairs the rule with its failure consequence. This matches the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

The gotchas give concrete, executable directives with exact file names, tools, and orderings: "Always push task files to MinIO before notifying Worker", "Read SOUL.md before composing notifications", "include a suggestion to use `find-skills`". However, the body never shows how to actually invoke the scripts it names (e.g., no `scripts/manage-state.sh` usage example) — invocation detail is deferred to references — which leaves minor gaps versus copy-paste-ready guidance.

4 / 5

Workflow Clarity

The body provides routing rules and an excellent situation-to-doc table, but no sequenced end-to-end workflow — the actual step sequences live in the reference files, and the body's implicit order (select worker → register in state.json → push to MinIO → notify → pull results) is scattered across gotchas rather than presented as a sequence. There are also no validation/checkpoint steps in the body itself for risky operations (state modification, task registration), matching the 'sequence present but checkpoints missing or implicit' anchor.

3 / 5

Progressive Disclosure

Scored against the actual bundle: all four referenced files (`references/worker-selection.md`, `finite-tasks.md`, `infinite-tasks.md`, `state-management.md`) exist and match the routing table exactly, and the "Read the relevant doc before executing. Do not load all of them" instruction is exemplary disclosure signaling. It falls short of a 5 because references are not strictly one level deep — `finite-tasks.md` points to `infinite-tasks.md`, `worker-selection.md` points to `team-management/references/team-task-delegation.md`, and `infinite-tasks.md` references a HEARTBEAT.md outside this bundle — a minor second-hop organization gap.

4 / 5

Total

16

/

20

Passed

Description

61%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 trigger-focused description with genuinely natural, situational phrasing that would fire correctly in this multi-agent manager context. Its main weakness is one-sidedness: it answers 'when to use' thoroughly but never explicitly states what the skill does, capping both specificity and completeness.

Suggestions

Lead with a short explicit 'what' statement (e.g., "Delegates tasks to Workers and manages their lifecycle: assignment, completion reporting, and recurring scheduled tasks") before the 'Use when' triggers.

Add a few common trigger synonyms such as 'assign a task', 'worker finished', or 'check if a worker is busy' to broaden natural-phrasing coverage.

Disambiguate the 'recurring scheduled tasks' trigger from any heartbeat/scheduling skill by naming the actor (e.g., 'when creating or managing Worker cron tasks').

DimensionReasoningScore

Specificity

The description names the domain ("delegate to a Worker", "recurring scheduled tasks", "check worker availability") and implies several concrete actions, but every clause is a trigger condition — no explicit statement of what the skill actually does, leaving coverage of its capabilities implied rather than listed. It sits above the score-2 anchor ('names domain but actions minimal') because the trigger clauses carry real action content, but below score 4, which expects several specific actions explicitly listed.

3 / 5

Completeness

The 'when' is strong — an explicit "Use when" clause with four concrete triggers — but the 'what' is never stated; the skill's function (managing delegation of tasks to Workers) is only inferable from the triggers. This is above score 2 ("only 'when' present without 'what'", e.g., "Use when working with documents") because the when-clauses embed actions, but below score 4, which requires both an explicit what and when.

3 / 5

Trigger Term Quality

Natural phrases a user would say are well covered: "admin gives a task", "Worker reports task completion", "recurring scheduled tasks", "check worker availability". A few natural variations are missing (e.g., 'assign a task', 'worker finished/done', 'task status'), so it does not reach the comprehensive-with-synonyms level of score 5.

4 / 5

Distinctiveness Conflict Risk

The Worker-delegation domain is a clear niche with distinct triggers, unlikely to fire for unrelated skills. Minor overlap risk remains with closely related skills (e.g., a heartbeat/scheduling skill for "recurring scheduled tasks" or a worker-status skill for "check worker availability"), which keeps it below score 5.

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

agentscope-ai/AgentTeams

Path

manager/agent/skills/task-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.