CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

project-management

Use when admin asks to start a multi-worker project, when a Worker @mentions you with task completion in a project room, when project plan changes are needed, or when a blocked task needs resolution.

Quality

77%

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/skills/project-management/SKILL.md
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.

The body is an exemplary router-style skill: lean gotchas encoding hard-won operational constraints, a clean situation→reference dispatch table, and all referenced bundle files present and one level deep. The only room for improvement is that some inline operations (e.g., MinIO sync) are named without any inline command, relying fully on the references for executable detail.

DimensionReasoningScore

Conciseness

The ~35-line body is dense with non-obvious operational knowledge only ("Check YOLO mode BEFORE drafting the plan", "Do NOT proceed to next phase while REVISION_NEEDED is pending", the exact shell test `[ "${AGENTTEAMS_YOLO:-}" = "1" ] || [ -f ~/yolo-mode ]`) with zero padding and no explanation of concepts Claude already knows. Every token earns its place, matching anchor 5; anchor 4 requires over-explanation worth trimming, which is absent.

5 / 5

Actionability

The body gives a copy-paste-ready shell check for YOLO mode, a situation→document routing table, and concrete imperatives ("always invite admin", "Always sync to MinIO after changes", "use references/plan-format.md as the canonical format"). It is mostly executable guidance with minor gaps — operations like MinIO sync and task assignment are named but their commands live in the reference files, so it sits at anchor 4 rather than anchor 5's fully copy-paste-ready coverage, and well above anchor 3's pseudocode-level guidance.

4 / 5

Workflow Clarity

The body is a router with explicit ordering guards ("Check YOLO mode BEFORE drafting the plan", "Do NOT proceed to next phase while REVISION_NEEDED is pending", "'All tasks complete' step is mandatory") plus a situation→doc table that sends each operation to a step-by-step reference, all of which exist. This is clear sequencing with most checkpoints present, but the actual validation/feedback loops for the batch task lifecycle are delegated to the references rather than visible here, holding it at anchor 4 instead of anchor 5's explicit inline validate→fix→retry steps.

4 / 5

Progressive Disclosure

The body is a concise overview with a clear Situation→Read table pointing to four one-level-deep reference files (create-project.md, task-lifecycle.md, plan-format.md, plan-changes.md), all of which exist in the bundle, along with an explicit instruction to load only the relevant one ("Do not load all of them"). This matches anchor 5 exactly — well-signaled, appropriately split, easy navigation; anchor 4 would require organization gaps that are not present.

5 / 5

Total

18

/

20

Passed

Description

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

The description has strong, distinctive trigger coverage and a clear niche, but it is entirely a 'when' clause — it never states what the skill actually does, which is its main weakness. Adding a one-line capability statement (e.g., orchestrating project rooms, plan.md task tracking, and blocked-task resolution) would raise completeness and specificity substantially.

Suggestions

Add a 'what' clause before the 'Use when' clause stating the concrete capabilities, e.g., 'Create multi-worker projects with Matrix project rooms, maintain plan.md as the single source of truth, assign/track tasks, and resolve blocked tasks.'

Include key artifact and workflow nouns users would naturally mention (project room, plan.md, task assignment, headcount) to broaden trigger-term coverage beyond the current four scenarios.

Consider naming the environments/tools involved (Matrix, MinIO) so the description disambiguates from generic project-management skills.

DimensionReasoningScore

Specificity

The description names the domain (multi-worker project management) and lists concrete scenarios like "when a Worker @mentions you with task completion in a project room" and "when a blocked task needs resolution", but it never states what actions the skill actually performs — the capabilities are only implied by the trigger situations. It fits anchor 3 (domain plus 1-2 concrete actions implied, not comprehensive) better than anchor 4 (several specific actions listed) and is clearly above anchor 2, whose example is a bare "Processes PDF files" with no concrete scenarios at all.

3 / 5

Completeness

The 'when' half is explicit and concrete (four "Use when..." triggers), but the 'what' half is entirely absent — the description never says what the skill does (create project rooms, maintain plan.md, assign and track tasks). This matches anchor 2's example "Use when working with documents" (only 'when' present without 'what') exactly; anchor 3 requires a clear 'what', and anchor 4 requires both.

2 / 5

Trigger Term Quality

Phrases like "start a multi-worker project", "plan changes", "task completion", and "blocked task" are natural things an admin or worker in this multi-agent environment would say, giving good keyword coverage. It falls short of anchor 5's comprehensive synonym/extension coverage (no "project room", "assign task", or artifact-name variations like plan.md), and is well above anchor 3's single generic keyword.

4 / 5

Distinctiveness Conflict Risk

Triggers like "when a Worker @mentions you with task completion in a project room" are highly specific to this multi-agent orchestration niche, with minimal overlap risk against generic project or task skills. It clearly matches anchor 5 (clear niche, distinct triggers); anchor 4's example ("Works with PDF and Word document files") still admits overlap between related formats, which does not apply here.

5 / 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/project-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.