Content
86%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 tight, high-signal principle skill: lean prose, concrete verification directives, a clear sequence for code work, and appropriately self-contained structure. The main gap is the absence of even one worked example (e.g., a sample re-runnable check script) to anchor the 'Script the check' guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 26-line body is lean and assumes Claude's competence, adding only non-obvious guidance (e.g., 'Agents report what they intended, not always what happened' and 'suspect the observation method before suspecting the system'). Nothing explains concepts Claude already knows, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Concrete, specific directives throughout — 'Check process liveness directly', 'inspect the actual output artifact (git diff, file contents, runtime behavior)', numbered build/run/check-chain/end-to-end steps — and the code-vs-instruction note means absence of code is not penalized. It sits at 4 rather than 5 because there is no worked example or command (e.g., a sample re-runnable comparison script) covering the common cases. | 4 / 5 |
Workflow Clarity | The 'Code and features' numbered sequence (build → run the actual path → check the full chain → test end-to-end) plus checklist bullets and an error-recovery heuristic ('When verification fails, suspect the observation method') give a clear sequence with most checkpoints present. It is not a destructive/batch skill, so no cap applies; it misses 5 only because the sequence is fully explicit just for code tasks while general tasks get the single 'Pattern' question. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and per the simple-skill guideline well-organized sections suffice: intro/Why/Pattern, a checklist, a delegation section, and a clearly signaled cross-skill pointer ('the **show-me-your-work** skill'). Structure is flat but navigable, matching the 5 anchor for small self-contained skills. | 5 / 5 |
Total | 18 / 20 Passed |