Content
81%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.
A dense, highly disciplined methodology skill: the workflow is clearly sequenced with genuine gates and validation loops, and the guidance is concrete enough to execute without guessing. Its main weakness is token efficiency — an over-written rhetorical style and triple coverage of the same rules (rules → phases → failures) make the body far longer than its content requires — and a secondary one that the body keeps nearly everything inline rather than splitting more into the (well-signaled) bundle files.
Suggestions
Rewrite the rhetorical flourishes as plain directives (e.g. 'manufacturing a decision that has all the authority of one and none of the examination' → 'presenting an unexamined solution as a decision'), which could cut the body by roughly a third without losing any rule.
Deduplicate the triple coverage: state each rule once in its phase section and reduce 'Common failures' to one-line pointers ('see Critical rules, #4'), or move the failures catalog to a one-level-deep reference file.
Trim examples inside the body where two illustrate the same point (e.g. the 'a decision that reads settled and is not' idea appears under both rule 6 and 'When to stop deciding').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body (~11,000 words) contains no padding about concepts Claude already knows — every paragraph carries skill-specific methodology — but the rhetorical style ('manufacturing a decision that has all the authority of one and none of the examination', 'the ceremony wearing an apology') roughly doubles the tokens a leaner phrasing would need, and the same rules are covered three times: stated in 'Critical rules', elaborated in the phase sections, then restated in 'Common failures' (e.g. the 'missing number is not evidence' point appears in rules 4, Evidence, and the failures section). This matches anchor 3 ('mostly efficient but... could be tightened') rather than 2, because the substance is not unnecessary explanation of known concepts, only over-written expression. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is exceptionally concrete: exact question sets per problem kind ('who hurts', 'what it costs today', 'what happens if nothing changes'), a copy-paste-ready validator command ('python3 <skill-dir>/scripts/validate_design.py .design/<name>.md' with the Windows fallback spelled out), a fixed decision grid, explicit status vocabularies ('clear', 'blocked by', 'rfc', 'spike', 'design'), and word budgets ('about 2,000 words... about 4,000, plus about 250 for each slice beyond eight'). Three worked examples (open decision, already committed, wrong skill) map user input → actions → result, covering the common cases. Per the scoring note, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | The multi-step process is explicitly sequenced ('SITUATION → PROBLEM → VERDICT → DECIDE') with the ordering rationale given, a hard gate ('Then stop. The user confirms before a single technical option is discussed'), and a dedicated validation section: run the validator, 'Fix every error', hand to a fresh reader, 'Check each finding before accepting it, fix what holds and run the validator again', plus a judgment checklist and a stopping rule. This is the anchor-5 pattern: clear sequence, explicit validation steps, feedback loops for error recovery, and checklists for a complex process. | 5 / 5 |
Progressive Disclosure | The bundle is well used: 'references/document-format.md' (verified to exist, 2,390 words, one level deep — it points back to SKILL.md rather than nesting further) and 'scripts/validate_design.py' are both real, and load timing is explicitly signaled ('Read references/document-format.md when you write the .design/<name>.md artifact — after the verdict is confirmed... Do not load it during the interview'). Scored against anchor 4 rather than 5 because the main body itself is a ~11,000-word monolith — material such as the ~60-line 'Common failures' catalog and the detailed slice-authoring rules could plausibly live in one-level-deep reference files, leaving SKILL.md closer to an overview. | 4 / 5 |
Total | 17 / 20 Passed |