Content
78%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.
The body is highly actionable and clearly sequenced, with concrete decision tables, fallback chains, and copy-paste spawn formatting. Its main weakness is progressive disclosure: it is a single monolithic file with no reference files, despite containing lookup material (model lists, role mappings) that would benefit from being split out.
Suggestions
Move the stable lookup material (Valid Models list, full fallback chains, role-to-model table) into a references file (e.g. references/models.md) and link to it one level deep, keeping the decision procedure and examples in SKILL.md.
Trim the redundancy between the 'Valid Models' section and the inline tables to tighten conciseness toward a lean 5.
Add an explicit final checkpoint in the workflow (e.g. 'Confirm resolved model, then pass as the model parameter') so the selection-to-spawn handoff is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and well-sectioned with tables and code blocks (e.g. 'Check these layers in order — first match wins', the task/role tables, the fallback chain blocks, the 'agent_type/model/mode' spawn block) and avoids explaining concepts Claude already knows; minor redundancy (the 'Valid Models' list re-states table contents) keeps it just below lean. | 4 / 5 |
Actionability | Fully actionable: an ordered 4-layer decision procedure, concrete task→model and role→model tables, explicit complexity adjustments, copy-paste fallback chains with exact model identifiers, and a ready spawn code block; four worked examples cover the common cases. | 5 / 5 |
Workflow Clarity | The 4-layer hierarchy is a clear ordered sequence and the fallback chain provides an explicit error-recovery loop ('Maximum 3 retries before using the platform default fallback'); this is non-destructive so no validation cap applies, but there is no explicit checkpoint confirming the resolved model before spawning. | 4 / 5 |
Progressive Disclosure | There are no bundle files and all content lives inline in a ~135-line SKILL.md; sectioning is good, but material that could be split out (the full role-to-model table, fallback chains, valid-models list) is inlined rather than surfaced via one-level-deep references. | 3 / 5 |
Total | 16 / 20 Passed |