Content
88%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 procedural skill body: exact executable commands, literal output formats, ordered filter rules, and explicit fallbacks for every failure mode, with zero concept re-teaching. The only refinement worth making is structural — offloading the mutually exclusive checkpoint flow to a reference file — plus trimming a few rationale clauses.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, purely operational, and explains nothing Claude already knows. A few one-clause rationales ("This gives the user a chance to catch a wrong pick", "better to summarize a slightly-off session than to refuse the handoff") and slight repetition of the empty-section rule could be trimmed, matching the level-4 anchor of efficient-with-minor-over-explanation rather than the fully lean level 5. | 4 / 5 |
Actionability | Commands are copy-paste ready throughout: exact `entire` CLI invocations with flags, concrete grep pipelines with head/tail bounds, a specific jq extraction, and literal announcement strings. The adaptive parts ("adapt the path based on what `jq 'keys'` showed") are explicitly justified by version-varying transcript shapes, and a Read-tool fallback covers the remaining case. | 5 / 5 |
Workflow Clarity | Both flows are clearly sequenced with numbered steps, and every step has explicit validation and recovery branches: non-JSON output falls back to prefix matching, empty filter results fall back to the unscoped list or self, rejected flags stop with an upgrade message, unrecognized transcript shapes fall back to the Read tool, and an unanswered question gates continuation. This is a well-instrumented decision tree, not a bare step list. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the single SKILL.md is well-sectioned (Response Format, STOP rules, two labeled flows with per-step headers) with no content that clearly belongs in a separate reference file. It misses level 5 only because at ~137 lines the self-contained checkpoint flow (~30 lines, mutually exclusive with the default flow) could be split into a one-level-deep reference to save tokens on the common path. | 4 / 5 |
Total | 18 / 20 Passed |