Content
60%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.
The body itself is exemplary for a pointer skill — lean, well-structured, with clearly conditioned references — but it delegates 100% of its substance to two files that are absent from the bundle, so the skill delivers no actionable test-writing guidance. Either ship the referenced files or inline the core guidance.
Suggestions
Add the referenced files (test-design-and-writing.md and spec-loop-task-verification.md) to the bundle (e.g., in a references/ directory), since the entire value of the skill depends on them and they are currently missing.
Inline a minimal core — e.g., one example of a behavioral test name and the setup/action/expected-result structure — so SKILL.md delivers guidance even when a reference cannot be loaded.
Add fallback guidance for what to do when an applicable reference file is unavailable, so the workflow does not dead-end.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~20-line body is lean and every line earns its place: a two-sentence scope note, two conditionally-triggered reference pointers, and a return instruction. No explanation of concepts Claude already knows and no padding, matching the top anchor. | 5 / 5 |
Actionability | The routing guidance is conditional and specific ("Read each applicable reference fully", "Do not load it for standalone test work"), but the actual test-design and naming guidance lives entirely in test-design-and-writing.md and spec-loop-task-verification.md, neither of which exists in the bundle — the specific steps to execute are missing. Not a 1 because the routing instructions themselves are concrete rather than abstract. | 2 / 5 |
Workflow Clarity | As a simple router skill the single action is unambiguous: read the applicable reference(s) by condition, then "Return to the invoking workflow afterward", with explicit negative guidance for the Spec Loop-only file. Not a 5 because the central step — reading the referenced files — cannot actually be executed since neither file is present in the bundle. | 4 / 5 |
Progressive Disclosure | The reference signaling is well-formed (one level deep, each with trigger conditions and a content preview), but scored against the actual bundle structure both referenced paths are dangling — no reference files exist anywhere in the bundle. There is no content to progressively disclose, leaving the structure non-functional rather than merely imperfect (anchor 3's 'not clearly signaled' or anchor 2's 'buried' don't apply, but the effective deliverable is as empty as the anchor-2 failure). | 2 / 5 |
Total | 13 / 20 Passed |