Content
88%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.
This is a well-built instruction/routing skill: the multi-step framing workflow is explicitly sequenced with confirmation checkpoints and error-recovery loops, the guidance is copy-paste actionable, and detailed handoff templates are correctly split into six clearly labeled reference files. The only notable issues are a triple-repeated expertise-bias warning and the lack of inline links from the routing table to the corresponding handoff templates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and efficient — tables, terse bullets, and copy-paste templates that assume Claude already knows Cynefin rather than re-teaching it. It is not a 3 because there is little concept re-teaching, and not a 5 because the LLM-expertise-bias warning is repeated three times (the section 0 "LLM bias warning", the anti-pattern "NEVER classify as Complicated just because you have knowledge", and the "NEVER let T1 alone override" section), which could be consolidated. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction skill: exact AskUserQuestion question texts with numbered answer options (T1-T3), a complete Domain→Verb→Route routing table with named downstream skills, template outputs to present (auto-classification block, domain map), and a handoff prompt. Not a 4 because the specific examples (three usage examples covering vague bug, feature request, and composite decomposition) cover the common cases with no notable gaps. | 5 / 5 |
Workflow Clarity | A clearly numbered pipeline (0 auto-classify → 1 triangulate → 1.5 decompose → 2 classify+route → 3 handoff) with explicit validation checkpoints at each decision point: the Adjacent Domain Challenge before confirming auto-classification, "Confirm? [Yes / Re-classify manually]", "Adjust / Confirm / Re-frame", and the final "Proceed?" gate, plus an error-recovery loop (the AskUserQuestion empty-answer guard with a fallback and wait instruction). This is a non-destructive routing skill, so no destructive-operation cap applies; not a 4 because checkpoints and feedback loops are explicit rather than implicit. | 5 / 5 |
Progressive Disclosure | Six real one-level-deep reference files in references/ are listed in a clearly labeled References section, each annotated with the exact domain condition it serves (e.g., "handoff template: Complex, no hypothesis → brainstorm"), and the decision logic is appropriately kept inline. Not a 5 because the references are only listed at the bottom — the Step 2 routing table and handoff steps never link to them inline at the point where each template would be used; not a 3 because the references are well-signaled and the split is appropriate. | 4 / 5 |
Total | 18 / 20 Passed |