Content
100%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 skill body: a five-step pipeline of copy-paste-ready commands with explicit stop conditions and an aggregator validation gate, hard rules that are all enforceable, and a clean one-level-deep reference structure. It assumes Claude's competence and spends every token on procedure and gates rather than explanation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout — it assumes Claude's competence (never explains mktemp, diff -u, chmod 0600, or rubric judging) and every line is instruction, exit code, gate, or file pointer, matching the 5 anchor; there is no padded or over-explained section to trim, so not 4. | 5 / 5 |
Actionability | Fully executable guidance: copy-paste commands with exact flags and paths (`python scripts/score_aggregator.py --inventory ... --emit-template > "$RUN/session_scores.json"`, `diff -u <current> <proposed>`), an exit-code table, and `--help/--output json/--sample`; no pseudocode or missing key details, matching the 5 anchor rather than 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with explicit validation checkpoints and feedback loops: step 1's "if `sessions_sampled` is 0 ... and stop", step 4's "**Exit 4 is a stop**: fix what it names and re-run; never hand-edit report.json", and the step-5 gate "apply only on an explicit yes, skill by skill" — the exact validate→fix→re-run, only-proceed-when-valid pattern of the 5 anchor, so the batch/destructive cap at 3 does not apply. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with a dedicated references section listing eight one-level-deep, well-signaled paths (`scorers/efficiency.md`, `scorers/code-quality.md`, three `references/*.md`, three `assets/*.json`), each with a one-line purpose; no nesting or buried references, matching the 5 anchor. | 5 / 5 |
Total | 20 / 20 Passed |