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 router-style SKILL.md: lean, fully actionable, with verified one-level-deep progressive disclosure and explicit validation gates for suites and evidence. The only soft spot is that the general workflow order is implied by rules rather than stated as a sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean routing table of one-line pointers plus dense operational rules; it explains nothing Claude already knows and every line carries actionable information (env vars, commands, gates). Fits the 'lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | Copy-paste-ready commands with concrete arguments ('bin/lbs fixture check', 'bin/lbs suite start <suite-id>', 'bin/lbs test result <case-id>', 'bin/lbs suite report <suite-id> --evidence-dir <dir>'), exact env var names, and exact reference paths. Per the code-vs-instruction note, the absence of code in this instruction-only router is not penalized. | 5 / 5 |
Workflow Clarity | The suite lifecycle (suite start → per-case test result → suite report), preflight-before-gate ordering, and explicit validation gates ('Do not mark a case pass until test result --evidence covers every value in evidence_required', 'A WebUI test is not complete until the visible UI result is checked against backend logs') give clear checkpoints. Not 5 because the overall workflow ordering is implied by scattered rules rather than an explicit sequenced overview, and error-recovery loops live in troubleshooting.md. | 4 / 5 |
Progressive Disclosure | A clean overview routing to 15 clearly signaled, one-level-deep reference files, all verified to exist, with detail appropriately split into the references (~1500 lines total) and the body kept minimal. Matches the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 19 / 20 Passed |