Content
71%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 a highly actionable router: exact commands, filename heuristics, a decision-ordered RULE ZERO, and explicit tie-breaking and fallback rules leave no ambiguity about what to do first. Its weaknesses are redundancy — duplicated keyword rows routing the same terms to different skills, and procedural content repeated from the frontmatter — and a monolithic inline structure that keeps everything in SKILL.md rather than splitting the routing table and script catalog into reference files.
Suggestions
Deduplicate the routing table: the peptide-target row appears verbatim in §2 and §4, and 'microbiome'/'16S' route to both tooluniverse-metagenomics-analysis and tooluniverse-microbiome-research with no tie-break — pick one destination or add a rule.
Move the ~25-row Bundled Scripts table and the per-domain keyword tables into reference files (e.g., references/routing-table.md, references/scripts.md), keeping only the routing procedure and the highest-frequency signals in SKILL.md.
Trim the duplicated RULE ZERO prose: the executed-notebook instructions already appear almost verbatim in the frontmatter description; state them once in the body in their full form.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational with almost no explanation of concepts Claude already knows, but it carries clear fat: the peptide-target row appears verbatim in both §2 and §4, "microbiome"/"16S" route to two different skills in §9 (metagenomics-analysis vs microbiome-research), the ~25-row "Bundled Scripts" table cross-references other skills' directories, and RULE ZERO's notebook instructions duplicate the frontmatter description nearly word-for-word. This matches anchor 3 ('mostly efficient but includes some unnecessary content or could be tightened'), below anchor 4 because of the duplicated rows and cross-skill catalog. | 3 / 5 |
Actionability | Guidance is fully executable throughout: exact commands like `tu run read_executed_notebook '{"data_folder":"/path/to/data","search":"<keyword>"}'` and `cd /path/to/data && python3 run_*.py`, copy-paste one-liners for each recurring tool (e.g., `tu run clinical_trial_ae_severity_test '{"dm_file":"DM.csv",...}'`), concrete filename heuristics ("`*_counts.csv`+`*meta*.csv` → RNA-seq DE"), and explicit routing calls `Skill(skill="<name>")`. This matches anchor 5's copy-paste-ready commands covering the common cases. | 5 / 5 |
Workflow Clarity | The routing workflow is a clear numbered sequence (read question AND file list → find keyword row → call Skill → follow loaded skill), RULE ZERO defines an ordered decision procedure (executed notebook → canonical script → own code) with canonical-vs-scratch script disambiguation, and tie-breaking rules plus fallbacks ("If no signal matches → general strategies", "Still ambiguous: Ask user") handle edge cases. It sits at anchor 4 rather than 5 because there are no post-route verification checkpoints and the duplicate keyword rows (two microbiome routes, IC50 in both §4 and §7) create unresolved ambiguities the tie-break rules don't explicitly cover. | 4 / 5 |
Progressive Disclosure | The one bundle reference is properly signaled and one level deep — "load [references/general-strategies.md](references/general-strategies.md)" points to a file that exists — but ~250 lines of keyword routing table plus a cross-skill script catalog are inlined in SKILL.md when they could be split into reference files, matching anchor 3 ('content that should be separate is inline'). Not anchor 4: the routing table and Bundled Scripts table are the bulk of the document and are not separated; not anchor 2: the structure that exists is well-sectioned and the single reference is clearly signaled, not buried. | 3 / 5 |
Total | 15 / 20 Passed |