Content
92%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 body: lean, tool-specific where it matters, with a well-sequenced supervision loop and explicit verification gates. The only gap is slightly incomplete command syntax for the detail step and no worked example of a relayed instruction or status report.
Suggestions
Write the detail step as a full command (e.g. "ai-devkit agent detail --tail 10 --id <id>") so it is copy-paste ready.
Include a one-line example of an acceptable brief status report to anchor step 4 of the loop.
Show a minimal template for a self-contained instruction sent to a waiting agent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is operational; no concepts Claude already knows are explained, and non-obvious tool knowledge ("reason: \"timeout\" is normal", "Never use a long sleep: harnesses block or kill it") earns its tokens. Matches the score-5 anchor 'every token earns its place'. | 5 / 5 |
Actionability | Concrete commands are given ("agent list --json", "ai-devkit agent wait --json" with --id/--group guidance) and the action vocabulary is specific (approve, clarify, correct, delegate, relay, verify, escalate). It sits below score 5 because "detail --tail 10" is not a full copy-paste invocation and there is no example of a self-contained instruction or a report status line. | 4 / 5 |
Workflow Clarity | A clear 5-step loop with explicit validation checkpoints ("never assume names/statuses", "Inspect waiting, idle, unknown, missing, or stale agents before acting", "Use verify before accepting any agent's completion claim") and an error-recovery loop for wait timeouts. Matches the score-5 anchor's explicit validation and feedback loops. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references (no references/, scripts/, or assets/ bundles exist), and is cleanly organized into Rules, Loop, and Completion sections. Per the rubric's simple-skill guidance, this earns a 5. | 5 / 5 |
Total | 19 / 20 Passed |