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 router-style SKILL.md: a 14-row intent table pointing to a well-organized, verified 17-topic reference tree, plus crisp boundary rules with one concrete command. The single weakness is verbosity in the longest routing cells (planning, model-selection, deployment), which restate conditions and could be trimmed by roughly a third without losing routing information.
Suggestions
Tighten the planning and model-selection routing cells: state the use-case-specification recommendation once (e.g., 'Route to use-case-specification first unless the user provides a model name/ID or declines') instead of the current recommended-then-qualified double statement.
Split the overloaded deployment row's sub-workflow triggers into shorter phrases, or move the plain-deploy vs benchmarking vs recommendations distinction into the model-deployment overview and keep only the routing trigger in the table.
Add one line noting the folder convention (each topic folder begins with overview.md, with deeper references/, scripts/, code_templates/ inside) so first-time navigation needs no folder exploration.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean router with no explanation of concepts Claude already knows — intro sentence, routing table, four rules. However, several routing cells are wordy: the planning cell runs ~90 words, and the model-selection cell states the use-case-specification recommendation twice ('**Recommended:** route to use-case-specification first... Routing to use-case-specification first is not required if user provides a specific model name/ID or declines'). This fits anchor 4, 'Efficient; minor instances of over-explanation that could be trimmed', rather than 5, since those cells could be tightened without losing routing content. | 4 / 5 |
Actionability | Every routing row maps a concrete user utterance to a specific verified path (all 14 referenced folders exist on disk), the model-selection row pins a specific file ('Base model filtering for deployment MUST go through select-for-deployment.md and its scripts'), and the rules include a copy-paste command ('export AWS_SDK_UA_APP_ID=AWSSkill-SageMaker'). For an instruction-only routing skill this is fully actionable; matches anchor 5 under the code_vs_instruction_skills note. | 5 / 5 |
Workflow Clarity | Sequencing is explicit: 'Load this reference FIRST when the request matches multiple rows', 'Requires a base model to be selected first', and ambiguity gates such as 'model-selection MUST confirm which path before proceeding' and 'ask one service-choice question. Do not select a service by default.' This is a single-purpose router under 50 lines whose single action is unambiguous with explicit decision checkpoints, meeting the simple-skill exception for a 5; no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: SKILL.md is a clean overview whose only content is intent-to-folder routing, all 14 linked paths are real, and each of the 17 topic folders leads with a substantive overview.md (verified 98–171 lines of real routing rules and prerequisites, not pointer-chains) that in turn signals its own references/, scripts/, and code_templates/. Content is appropriately split across 117 files with nothing inlined that belongs in a reference, matching anchor 5, 'Clear overview with well-signaled... references; content appropriately split; easy navigation'. | 5 / 5 |
Total | 19 / 20 Passed |