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: a clearly sequenced five-phase protocol with explicit confirmation checkpoints, override handling, and concrete question templates, backed by a well-organized one-level-deep reference bundle. The only minor improvement is tightening the discursive Mindset prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: nearly every section (rules with WHY rationale, BAD/GOOD contrast examples, per-phase question banks) teaches skill-specific behavior rather than concepts Claude already knows. It stops short of 5 because the opening 'Mindset' section is discursive prose ('The Socratic method is a disposition, not a checklist...') that could be trimmed to a couple of lines without losing guidance value. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: copy-paste-ready question templates per phase ('What specifically does [term] mean in your context?'), concrete BAD/GOOD dialogue examples for leading questions, contradiction-acceptance, and override handling, plus a ready-made opening message. It is not a 4 because the examples cover the common cases completely with no gaps. | 5 / 5 |
Workflow Clarity | The five phases are clearly sequenced in order with explicit checkpoints: Phase 5 confirmation is required before acting ('NEVER skip Phase 5 before acting'), contradictions must be surfaced rather than accepted (a feedback loop), and the user-override path ('just do it' → acknowledge, name what was skipped, proceed) is specified. This matches the anchor for clear sequence with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | SKILL.md is a lean overview; all four cited reference files exist in references/ (question-taxonomy.md, classical-foundations.md, anti-patterns.md, worked-examples.md), are one level deep, and each link is labeled with a one-line description of its contents — exactly the well-signaled single-level reference structure the top anchor describes. | 5 / 5 |
Total | 19 / 20 Passed |