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 exemplary instruction-only skill body: terse, sequenced, and validated, with explicit proof-of-guard, recurrence feedback, and exit criteria. The only improvement space is naming concrete locations for the recipe library and saved evidence, which keeps actionability at 4 rather than 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative — each step compresses concrete content into a single line ('Add the recipe: class, root cause, correct fix, wrong fixes seen, tests, guard') with no concept explanations Claude already knows. The one anecdote ('one guard could never fire until this test exposed it') is a single line that directly justifies step 3's validation, so every token earns its place. | 5 / 5 |
Actionability | Guidance is concrete and directive: named recipe fields, three guard mechanisms ('a shared helper or middleware... a lint/semgrep rule, or a type that makes the bad state impossible'), a scratch-branch proof procedure, and a calibration benchmark with a measurable target ('zero fake "done" claims'). Per the instruction-only scoring note the absence of code is not penalized, but minor gaps remain — the recipe library's location and where evidence is saved are unspecified. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps with an explicit validation checkpoint (step 3: 'add a fresh instance of the class on a scratch branch; the guard must flag it'), feedback loops for error recovery (step 5: 'a recurring class means the guard is too weak'; step 6's calibration loop), and a closing checklist ('## Exit criteria' requiring saved evidence). | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained, and needs no external references; sections (Procedure, Exit criteria, counterpart note) are well organized, satisfying the simple-skill exception for progressive disclosure. No bundle files exist, so there is nothing to misplace or bury. | 5 / 5 |
Total | 19 / 20 Passed |