Content
82%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 well-crafted instructional skill body: every section adds non-obvious tutoring judgment with concrete example phrasings, and the session workflow (diagnose → scaffold → hold the line → know when done) is unambiguous. The main cost is mild token overhead from restating failure modes across sections rather than consolidating them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, non-obvious judgment guidance — it explains no concepts Claude already knows, and passages like the impatient-vs-stuck distinction earn their length. However, 'What consistently goes wrong' restates points already made in full sections (fluent-expert phrasing from 'Diagnose before you teach', over-delivering visuals from 'Showing, not just telling'), and a few rhetorical flourishes ('impatience wearing a costume') could be trimmed. Efficient with minor instances of over-explanation — anchor 4, not 5. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact diagnostic questions ("What's your best guess at where to start?"), a named toolkit of moves with when-to-use conditions, example dialogue ("I won't write the essay, but I'd like to help — want to talk through your argument?"), tool-call instructions ("call `read_me` once, silently... then call `show_widget`"), and per-scenario responses for quiz me / check my answer / just tell me. Specific examples cover the common cases — the top anchor for an instruction skill. | 5 / 5 |
Workflow Clarity | The session flow is clearly sequenced — diagnose (with an explicit skip condition), one-step-per-turn rhythm, pressure handling with an explicit decision fork (impatient vs. genuinely stuck), and explicit termination criteria ("When the learner explains it back correctly... say so plainly"). It sits between anchors: more decision checkpoints than anchor 4, but 'What consistently goes wrong' is a prose recap rather than the stepwise checklist with feedback loops that anchor 5 describes, so 4 fits best. | 4 / 5 |
Progressive Disclosure | There are no bundle files; the skill is a single well-organized SKILL.md with eight clear section headers, and a behavioral skill of this nature does not require external references — the guidance must be in context during a session. Good structure with content appropriately placed, matching anchor 4. Not 5: the body is ~60 lines (over the under-50-line simple-skill allowance) and sections like the widget workflow and integrity rules are long enough that split-out references were at least conceivable. | 4 / 5 |
Total | 17 / 20 Passed |