CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tooluniverse-metabolomics

Metabolomics research — metabolite identification, study analysis, and database searches across HMDB, MetaboLights, Metabolomics Workbench, KEGG. Use for annotating mass-spec features to known metabolites, finding metabolomics studies of a disease, and structured metabolomics research reports with metabolite-pathway mapping.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

60%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Operationally rich content — specific tools, SOAP quirks, fallback strategies, and a genuinely useful evidence-grading reasoning framework — undermined by padding in the Summary/Key Features/Best for sections and by a broken bundle layout: it references files that don't exist and ignores the script it actually ships. Trimming the redundant sections and fixing the reference structure would lift this substantially.

Suggestions

Fix the reference structure: either add the referenced QUICK_START.md and .env.template to the bundle, or remove those pointers; and reference scripts/metabolism_ref.py from SKILL.md so the shipped script is discoverable.

Delete the redundant "Summary", "Key Features", and "Best for" sections (~25 lines) — they restate the Use Case and Research Workflow sections verbatim in concept and add no operational value.

Move the Input Parameters tables and Usage Patterns to a one-level-deep reference file (e.g., USAGE.md), keeping SKILL.md as a concise overview of the 4-phase pipeline, SOAP quirks, and reasoning framework.

DimensionReasoningScore

Conciseness

Mostly efficient — the SOAP parameter handling, response-format variations, fallback hierarchy, and adduct-mass tables are non-obvious and earn their tokens — but there is clear padding: the "Summary" section restates the 4-phase pipeline, "Key Features" ("✅ 100% test coverage with working pipeline") is self-congratulatory metadata, and "Best for" duplicates the "Use Case" section. Not a 2 because the majority of the body is dense operational guidance rather than concept explanation, but it could be tightened by roughly a fifth.

3 / 5

Actionability

Concrete, executable guidance throughout: exact tool names ("HMDB_search", "metabolights_get_study"), exact parameters ("operation=\"search\"", "do not use endpoint or method"), numeric thresholds ("±5 ppm", "cosine > 0.7", "fold-change > 1.5"), and response-format handling ("Always check response type with isinstance()"). Per the instruction-skill scoring note, absent code is not penalized when guidance is actionable, but no inline runnable example exists and the promised Python examples live in a QUICK_START.md that is not in the bundle — minor gaps that keep this below anchor 5.

4 / 5

Workflow Clarity

The 4-phase pipeline is clearly sequenced with explicit fallback checkpoints (primary → fallback → "continue with remaining phases"), per-phase numbered steps, and a Common Issues section with cause/solution diagnosis. This is a batch operation, and validation is largely addressed (response-type checks before field access, fallback on failure), so the missing-validation cap at 3 does not apply; it is not 5 because there is no explicit verify-the-output step before finalizing the report.

4 / 5

Progressive Disclosure

The file structure is misaligned with the actual bundle: the body's only outbound references — "See QUICK_START.md" and "check .env.template" — point to files that do not exist, while the one real bundle file (scripts/metabolism_ref.py) is never referenced from SKILL.md at all. Additionally, ~290 lines of input-parameter tables, usage patterns, and reasoning framework are inlined in SKILL.md that could live in reference files. Well-labeled section headers prevent a score of 1, but broken references plus orphaned bundle content match anchor 2 (content that belongs in separate files inlined / references not usable).

2 / 5

Total

13

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

Strong description: third person, concrete, and explicit about both capabilities and trigger scenarios, with named databases that make it highly distinct. Only minor gap is synonym coverage for mass-spec terminology (m/z, LC-MS, small molecule).

DimensionReasoningScore

Specificity

Lists multiple concrete actions with named databases: "metabolite identification, study analysis, and database searches across HMDB, MetaboLights, Metabolomics Workbench, KEGG", plus "annotating mass-spec features to known metabolites" and "metabolite-pathway mapping". It matches the comprehensive-coverage anchor; a 4 would require minor gaps in coverage, but the what/how here spans the full capability surface.

5 / 5

Completeness

Explicitly answers both questions: what ("metabolite identification, study analysis, and database searches across HMDB, MetaboLights, Metabolomics Workbench, KEGG") and when ("Use for annotating mass-spec features..., finding metabolomics studies of a disease, and structured metabolomics research reports"). A concrete 'Use for' clause is present, so the missing-trigger cap of 3 does not apply; it is not 4 because the 'when' is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: "metabolomics", "metabolite", "mass-spec features", "annotate", "metabolomics studies of a disease", plus database names users would name. A few natural terms are missing (e.g., "small molecule", "LC-MS", "m/z", "metabolic pathway"), so it falls below the comprehensive-synonym anchor 5 but clearly above anchor 3, which implies missing common variations.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: the metabolomics domain plus named databases (HMDB, MetaboLights, Metabolomics Workbench) would not fire for adjacent skills (proteomics, general chemistry, genomics). Minimal conflict risk; anchor 4 would require minor overlap with a closely related skill, which is not evident here.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

mims-harvard/ToolUniverse

Path

plugin/skills/tooluniverse-metabolomics/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.