CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-management

AI DevKit · Manage running AI agents with ai-devkit agent commands. Use when an agent needs to identify itself, list agents, start workers, inspect agent detail, assign work, group agents, resume sessions, stop agents, or delegate work to other agents.

Quality

93%

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

93%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 lean instruction-only skill: executable commands throughout, a sequenced workflow with safety guardrails (ask before killing agents you did not start; verify before reporting done), and zero concept over-explanation. The single gap is that the verify step and send-failure handling (timeout behavior, what to do on no response) lack concrete feedback-loop detail.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence: no explanation of what agents are, a one-line fallback invocation ('if unavailable, use npx ai-devkit@latest'), a compact command block, terse assignment rules, and a single example. Every line earns its place, matching the score-5 anchor ('lean and efficient; assumes Claude's competence'). Even the advisory line about partial matches ('Partial matches are convenient but risk sending work to the wrong agent') is actionable guidance, not padding.

5 / 5

Actionability

All nine commands are fully executable with real flags and placeholders ('ai-devkit agent detail --id <name> --json --tail 20', 'send --wait --timeout 120000'), plus a copy-paste-ready example assignment with objective, scope, constraints, and expected output format. This matches the score-5 anchor ('fully executable; copy-paste ready; specific examples cover the common cases'); it is well above 4, which tolerates minor gaps — none are evident here.

5 / 5

Workflow Clarity

The six-step workflow is clearly sequenced (list → identify self → inspect → reuse/start → send → verify) and includes checkpoints like 'Inspect before acting' and 'Verify completed work before reporting it done', matching the score-4 anchor ('clear sequence with most checkpoints present; minor validation gaps'). It is not a 5 because the verification step names no command or feedback loop (e.g., re-check 'agent detail --tail' output after completion, or how to handle a failed/timed-out send), and error-recovery guidance is absent.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no external reference files needed (no references/, scripts/, or assets/ directories exist), and it is organized into clean sections (Workflow, Commands, Assignment Rules, Example). Per the rubric's guideline for simple skills under 50 lines with no need for external references, well-organized sections alone warrant a 5. The one cross-skill pointer ('Use agent-communication for agent-to-agent updates') is a skill name, not a broken bundle path.

5 / 5

Total

19

/

20

Passed

Description

88%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: third-person voice, an explicit 'Use when' trigger clause enumerating concrete capabilities, and a clear tool anchor. The only improvement space is adding a few more natural trigger synonyms (spawn, kill, check on agents) to further reduce overlap with generic delegation skills.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'identify itself, list agents, start workers, inspect agent detail, assign work, group agents, resume sessions, stop agents, or delegate work' — giving comprehensive coverage of the command surface with no vague filler. It clearly matches the score-5 anchor ('lists multiple specific concrete actions; comprehensive coverage') and exceeds the score-4 example, which covers only three actions with gaps.

5 / 5

Completeness

It explicitly answers both questions: what it does ('Manage running AI agents with ai-devkit agent commands') and when to use it ('Use when an agent needs to identify itself, list agents, start workers...'), with concrete trigger phrases. This mirrors the score-5 good example structure exactly; the 'when' clause is explicit and enumerated rather than implied, so 4 ('when' could be more specific) does not apply.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are well covered ('list agents', 'start workers', 'assign work', 'delegate work', 'stop agents'), matching the score-4 anchor of good coverage with a few natural terms missing. It falls short of 5 because common variations like 'spawn', 'kill', 'check on agents', or 'message an agent' are absent, and it is not below 4 since the trigger list is concrete and multi-word rather than generic keywords.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — managing running AI agents via a named tool ('ai-devkit agent commands') — and the enumerated triggers are distinct, so it is 'mostly distinct; minor overlap risk' with closely related skills (generic delegation/multi-agent orchestration skills). It is not a 5 because 'delegate work to other agents' and 'assign work' are phrases that could overlap with broader agent-orchestration or task-routing skills.

4 / 5

Total

18

/

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

codeaholicguy/ai-devkit

Path

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