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 exemplarily lean, directive body: every line is an executable instruction covering pacing, question strategy, recommended answers, and a codebase-first shortcut, with a clear termination condition. As a sub-50-line single-purpose skill needing no external content, it fully satisfies the simple-skill exceptions for workflow clarity and progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~10 lines of pure directive text — "Interview me relentlessly about every aspect of this plan", "Ask the questions one at a time" — with zero concept explanation or padding. The only non-instruction text is a two-line MIT attribution footer, which is required licensing, so every token earns its place. | 5 / 5 |
Actionability | Every operational decision is explicitly specified: pacing ("Ask the questions one at a time"), question content ("Walk down each branch of the design tree, resolving dependencies between decisions one-by-one"), per-question behavior ("provide your recommended answer"), and a codebase-first rule ("If a question can be answered by exploring the codebase, explore the codebase instead"). Per the rubric's instruction-skill note, the absence of code is not penalized when the guidance is this concrete. | 5 / 5 |
Workflow Clarity | This is a simple single-task skill and the single action is unambiguous: iterate the design tree branch-by-branch, one question at a time, until the explicit termination condition "until we reach a shared understanding". The simple-skill exception applies, and there are no destructive or batch operations, so no validation cap is triggered. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and consists of well-organized short directives — matching the rubric guideline that such skills can score 5 with just good organization. The footer's pointer to the sibling /grill-with-docs skill for glossary/ADR projects actively aids navigation. | 5 / 5 |
Total | 20 / 20 Passed |