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 unusually well-executed instruction skill: a concrete seven-step protocol with named tools, hard gates, a troubleshooting table, a verification checklist, and real, well-labeled one-level-deep references. The only meaningful cleanup is the pseudo-executable "Quick diagnostic" bash block and minor repetition of the question budget.
Suggestions
Delete or replace the "Quick diagnostic" section — the command `echo "$USER_PROMPT" | head -c 200` does not "Returns 'interview' or 'answer-directly'" as its comment claims, so it reads as filler and is the weakest part of an otherwise fully actionable document.
State the 3-6 question budget once (in "When to use") and let protocol step 5 reference it, rather than repeating the count and the sufficiency check in both places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative — no concept explanations of things Claude already knows, and each rule is stated once with a WHY/BAD/GOOD trio. Two spots could be trimmed: the "Quick diagnostic" bash block (echoing "$USER_PROMPT" through head adds no real capability) and the 3-6 question budget, which is stated in "When to use", protocol step 5, and again implicitly in step 5's sufficiency check. This is anchor 4 (efficient, minor instances that could be trimmed), not 5. | 4 / 5 |
Actionability | Fully actionable instruction-only guidance: it names the exact tool ("Use the AskUserQuestion tool for a single question at a time"), fixes exact option counts ("3-4 concrete, mutually exclusive options"), gives a copy-ready opening script, per-situation troubleshooting responses, and concrete BAD/GOOD examples for every rule. Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this specific. | 5 / 5 |
Workflow Clarity | The 7-step protocol is clearly sequenced with explicit validation checkpoints: an adaptive check before each question ("does this answer make a planned question moot?"), a sufficiency gate ("could I write the recap right now without guessing?"), a hard confirm-before-finalize gate, and a closing verification checklist including contradiction-surfacing and file-existence checks. This matches the top anchor's sequence-with-explicit-validation-and-checklists pattern; no destructive or batch operations are involved. | 5 / 5 |
Progressive Disclosure | The body is a clear overview (~200 lines) with two well-signaled, one-level-deep references — [`question-design.md`](references/question-design.md) and [`worked-example.md`](references/worked-example.md) — both verified to exist, each annotated with exactly what it contains, and neither nesting further references. Content is appropriately split: the deep question-design rationale and the full transcript live outside the body. | 5 / 5 |
Total | 19 / 20 Passed |