CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fleet-manager

Use when managing, triaging, restarting, escalating, or summarizing Codewhale fleet runs and workers.

Quality

88%

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

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 instruction-only skill: fully concrete typed commands and API endpoints, a crisp classification taxonomy, explicit authority boundaries, and well-gated decision rules between restart and escalation, all with essentially zero wasted tokens. The only meaningful gap is the absence of a post-action verification loop (confirming a restart/resume actually succeeded before writing the receipt), which is the difference between a good and a fully self-correcting workflow.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — typed commands ('codewhale fleet inspect <worker-id>'), tight bullet checklists, and two compact templates with no padding, no explanation of concepts Claude already knows, and every line carrying operational weight. This matches the score-5 anchor 'lean and efficient; assumes Claude's competence; every token earns its place'; the only near-redundancy (step 5 of the Triage Loop vs. 'Restart vs Escalate') is reinforcing gate conditions, not over-explanation, so score 4's 'minor instances of over-explanation' does not fit better.

5 / 5

Actionability

The guidance is fully executable: exact CLI commands with arguments ('codewhale fleet logs <worker-id>', 'codewhale fleet resume <run-id>'), concrete Runtime API endpoints ('GET /v1/fleet/workers/{worker_id}'), a four-state classification taxonomy, and two copy-paste-ready templates (escalation draft, post-run receipt). This matches the score-5 anchor 'fully executable; copy-paste ready code or commands; specific examples cover the common cases' — the command-only skill needs no code samples, and nothing stays at the vague 'describe rather than instruct' level of score 3.

5 / 5

Workflow Clarity

The six-step Triage Loop is clearly sequenced with an explicit pre-action checkpoint ('Classify the state before acting') and the 'Restart only when all of these are true' checklist gates the risky actions, matching the score-4 anchor 'clear sequence with most checkpoints present; minor validation gaps'. It is not capped at 3 because validation is not missing — classification and the restart checklist are verification gates — but it falls short of 5 because there is no post-action feedback loop (e.g., re-inspect after restart to confirm recovery, or re-check for repeated failure) and step 6's receipt is recorded without verifying the typed action's effect.

4 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ are absent) and none are needed: the ~104-line body is a single coherent procedure split into well-labeled sections (Authority Boundary, Triage Loop, Restart vs Escalate, templates), matching the score-5 anchor's 'clear overview ... easy navigation' with content appropriately placed — the two short templates earn inline placement and there is no bulk that belongs in a separate file. It is above score 4 ('minor organization gaps') because there are no gaps: every section is discoverable and self-contained.

5 / 5

Total

19

/

20

Passed

Description

78%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, well-targeted description: explicit 'Use when' triggers, five concrete actions, and a distinctive product-specific domain that virtually eliminates conflict risk. Its main weakness is that the 'what' side rests entirely on generic verbs — the skill's real deliverables (classification, typed fleet actions, escalation drafts, receipts) are invisible from the description alone.

Suggestions

Name the skill's concrete outputs in the description, e.g. 'Classify worker state (transient/task/verifier failure, needs-human), take typed fleet actions (restart, resume, interrupt, stop), and leave receipts or escalation drafts.'

Add one or two natural user phrasings as trigger synonyms, e.g. 'worker is stuck', 'fleet run failed', or 'summarize a fleet run', to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description lists five concrete actions — 'managing, triaging, restarting, escalating, or summarizing' — on a named object ('Codewhale fleet runs and workers'), matching the 'lists several specific actions; minor gaps in coverage' anchor. It is not a 5 because the actions are generic verbs without any detail on what the skill actually produces (e.g., classifications, receipts, escalation drafts), and 'managing' is broad; it is above 3 because multiple specific actions and the target domain are both named.

4 / 5

Completeness

It has an explicit 'Use when' trigger clause with a full activity list ('Use when managing, triaging, restarting, escalating, or summarizing Codewhale fleet runs and workers') and the verb list doubles as the 'what', matching the anchor 'Has both what and when; when could be more explicit or specific'. It is not a 5 because the 'what' is thin — the description never states the skill's actual outputs (state classification, typed fleet actions, escalation drafts, receipts); it is above 3 because both what and when are explicitly present, not merely implied.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'fleet runs', 'workers', 'restarting', 'summarizing', 'triaging', 'escalating' — good keyword coverage matching the score-4 anchor. It falls short of 5 because common variations users might use (e.g., 'stuck worker', 'worker died', 'run summary', 'fleet health') and tool-specific terms like 'codewhale fleet status' are absent, though it is well above the sparse keyword coverage of score 3.

4 / 5

Distinctiveness Conflict Risk

'Codewhale fleet runs and workers' carves out a clear niche with distinct, product-specific triggers — no other generic skill (document processing, git, etc.) would collide with these terms, matching the score-5 anchor 'clear niche with distinct triggers; minimal conflict risk'. It cannot be a 4 because there is no identifiable overlap risk with a closely related skill.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

Hmbown/Codewhale

Path

crates/tui/assets/skills/fleet-manager/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.