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

82%

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

The canonical home for this skill is tooluniverse-metabolomics in mims-harvard/ToolUniverse

SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is rich in domain-specific, non-inferable detail (SOAP quirks, response formats, confidence-level grading) with a clear phased workflow, but it is padded with a redundant Summary/marketing checklist, buries reference-worthy material inline, and its only file pointer (`QUICK_START.md`) is broken while the bundled `scripts/metabolism_ref.py` goes unreferenced. Fixing the bundle wiring and trimming the duplicated sections would lift both conciseness and disclosure scores.

Suggestions

Remove or merge the "Summary" and "Key Features" sections into the workflow description — the ✅ checklist ("100% test coverage") makes claims about the code rather than instructing Claude and duplicates the Research Workflow.

Fix bundle wiring: either add the missing `QUICK_START.md` or repoint line 295 at the existing `scripts/metabolism_ref.py`, and reference the script from the body so the bundled resource is discoverable.

Move the "Reasoning Framework" (adduct mass table, L1–L4 evidence grading, biomarker criteria) and the per-tool parameter reference into a one-level-deep reference file (e.g., `references/reasoning.md`), keeping SKILL.md as a concise overview with clearly signaled pointers.

DimensionReasoningScore

Conciseness

The core guidance (SOAP `operation` parameters, response-format variants, fallback hierarchy, adduct mass corrections) is genuinely non-obvious and earns its tokens, but there is clear padding: the ~30-line "Summary" section restates the Research Workflow verbatim, the "Key Features" checklist ("✅ 100% test coverage with working pipeline") is a self-congratulatory claim rather than instruction, and "Usage Patterns" largely duplicates the four phases. This sits between 'mostly efficient' and 'noticeably verbose', so a midpoint 3 fits.

3 / 5

Actionability

Guidance is concrete at the instruction level: exact tool names and parameters (`HMDB_search` with `operation="search"`, `FooDB_get_compound` with `fdb_id="FDB000004"`), precise adduct-mass arithmetic, response-type handling via `isinstance()`, and concrete error/fix pairs. It misses a 5 because there is no executable code in the file and the only code resource it points to (`QUICK_START.md`, line 295) does not exist in the bundle.

4 / 5

Workflow Clarity

The 4-phase pipeline is explicitly sequenced per input type, with a documented fallback hierarchy, per-metabolite error handling that continues to remaining phases, and a "Common Issues" section giving cause/solution pairs (a soft feedback loop). It misses a 5 because the phases have no explicit validation checkpoints (e.g., when to abort vs. continue is only implied) and there is no re-check step after fallback to PubChem.

4 / 5

Progressive Disclosure

The body is a ~295-line monolith: the "Reasoning Framework" (adduct tables, evidence grading, biomarker criteria) and the per-tool reference material are prime candidates for separate reference files but are inlined. Worse, the one external pointer — "See `QUICK_START.md`" — is a dangling reference (no such file in the bundle), while the actual bundle file `scripts/metabolism_ref.py` is never mentioned or linked from SKILL.md. Structure exists but references are broken and content that should be separate is inline, matching the 3 anchor.

3 / 5

Total

14

/

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.

A strong description that clearly states both what the skill does and when to use it, with database-specific trigger terms and concrete action verbs. Minor room to add common user phrasings like "mass spectrometry" or "metabolite annotation" for even broader trigger coverage. One small risk: KEGG is named in the description but no KEGG-specific tools appear in the body.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "metabolite identification, study analysis, and database searches", "annotating mass-spec features to known metabolites", "finding metabolomics studies of a disease", "structured metabolomics research reports with metabolite-pathway mapping" — and names the specific databases (HMDB, MetaboLights, Metabolomics Workbench, KEGG). Coverage is comprehensive across the skill's capabilities; not a 4 because there are no meaningful gaps in the action list.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("Metabolomics research — metabolite identification, study analysis, and database searches across HMDB, MetaboLights, Metabolomics Workbench, KEGG") and the "when" ("Use for annotating mass-spec features to known metabolites, finding metabolomics studies of a disease, and structured metabolomics research reports") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good coverage of natural terms users would say: "metabolomics", "metabolite", "mass-spec features", "studies of a disease", plus the database names a user might mention (HMDB, KEGG). A few natural synonyms and phrasings are missing (e.g., "mass spectrometry", "m/z", "pathway analysis", "metabolite annotation"), so it falls between the 3 and 5 anchors, noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: metabolomics-specific vocabulary (metabolites, mass-spec, MTBLS-style study lookups) and named databases make it very unlikely to fire for a non-metabolomics skill. It does not overlap with generic bioinformatics or chemistry descriptions.

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

plugins/tooluniverse/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.