Content
67%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-organized router skill with genuinely actionable, specific guidance — named downstream skills, classification lanes, delegation rules, and a clear output contract. The main costs are duplication between the Entity Normalization and Skill Selection sections and the absence of a worked routing example that would make the workflow concrete.
Suggestions
Merge Entity Normalization and Skill Selection Heuristics into one skill-catalog section (or a single reference table keyed by entity type) — the same downstream skills are currently listed twice.
Trim the body's 'When To Use This Skill' section, which largely restates the frontmatter description's trigger conditions.
Add one short worked example: a sample broad question, the lanes chosen, the skills selected, and the shape of the synthesized answer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is list-driven and free of concepts Claude already knows, but it is noticeably redundant: Entity Normalization and Skill Selection Heuristics enumerate overlapping skill catalogs (chembl, pubchem, ensembl, uniprot, reactome, biostudies, ncbi-datasets each appear twice), and the body's 'When To Use This Skill' repeats the frontmatter trigger. It fits 'mostly efficient but could be tightened' better than the minor-trim anchor at 4, since the duplicate catalogs are a whole-section consolidation opportunity. | 3 / 5 |
Actionability | For an instruction-only routing skill the guidance is concrete: named downstream skills per entity type, nine classification lanes with a 'prefer 1 to 3' rule, an explicit subagent return checklist, and a numbered output contract. It falls short of fully executable because there is no worked example of a real question routed end-to-end, which keeps it at 'mostly executable guidance with minor gaps'. | 4 / 5 |
Workflow Clarity | The five-step process (understand → normalize → select → gather → synthesize) is stated up front and the sections follow it in order, with soft checkpoints like "Do not start broad evidence collection until the important entities are stable enough" and explicit subagent-avoidance criteria. There are no explicit validation/recovery loops, but routing is neither destructive nor batch, so no cap applies — 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so this scores on the SKILL.md structure itself: eight well-labeled sections in workflow order, no nested references, nothing buried. The long per-entity and per-lane skill catalogs (~40 downstream skill names) arguably belong in a single reference table, which is the 'minor organization gaps' that keeps it at 4 rather than the appropriately-split anchor at 5. | 4 / 5 |
Total | 15 / 20 Passed |