Content
93%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |