Skip to main content
skill CX Codex

tooluniverse-metabolomics-pathway — Claude Code skill: pathways

The tooluniverse-metabolomics-pathway skill connects metabolites with pathways, enzymes, genes, and diseases. Use it when metabolomics work needs cross-database identification and mapping.

Apache-2.0 238 installs ★ 1,798 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metabolomics-pathway -a claude-code
Open on GitHub

What tooluniverse-metabolomics-pathway does

The skill searches for metabolites by name, formula, mass, or identifier through PubChem and Metabolomics Workbench tools. It can return compound properties, classification, biological roles, and cellular locations. BridgeDb handles identifier links across HMDB, KEGG, and ChEBI.

It maps compounds to MetaCyc, KEGG, and Reactome pathways, then connects them with enzymes and genes. Disease links come from CTD and Metabolite_get_diseases; Reactome enrichment is available for metabolite-related gene lists.

For statistics and data processing, the workflow runs Python through Bash and can use pandas, scipy, statsmodels, and matplotlib. HMDB has no open API, so compound lookup goes through Metabolite_get_info. Check names before mapping: one common name can point to different isomers, while PubChem, CTD, and KEGG may use different names.

What it helps with

  • identify metabolites from names, formulas, or masses
  • convert identifiers between HMDB, KEGG, and ChEBI
  • map compounds to MetaCyc, KEGG, and Reactome pathways
  • link metabolites with enzymes and genes
  • find disease associations for a compound

Example prompts for the agent

  • Identify the metabolites in this list, resolve their IDs, and map them to KEGG and Reactome pathways.
  • Search for this compound by mass with the M+H adduct, then cross-reference the result with BridgeDb.
  • Run Reactome pathway enrichment for the enzyme genes linked to these metabolites, using Python through Bash for the calculation.

How to install tooluniverse-metabolomics-pathway

1Skills CLI (Vercel)

npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metabolomics-pathway -a claude-code

2Manually: put the files in place

~/.claude/skills/tooluniverse-metabolomics-pathway/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tooluniverse-metabolomics-pathway/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tooluniverse-metabolomics-pathway

How do I install tooluniverse-metabolomics-pathway in Claude Code?

Run npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metabolomics-pathway -a claude-code, then check ~/.claude/skills/tooluniverse-metabolomics-pathway/SKILL.md.

What does tooluniverse-metabolomics-pathway do?

It identifies metabolites, converts database identifiers, maps pathway membership, links compounds to enzymes and genes, and finds disease associations.

Why should metabolite identity be checked before pathway mapping?

A shared common name can refer to different structural isomers. PubChem names can also differ from the names used by CTD and KEGG.

Source text

SKILL.md · Apache-2.0
---
name: tooluniverse-metabolomics-pathway
description: Metabolomics pathway analysis — metabolite identification (HMDB, KEGG, ChEBI), pathway mapping (Reactome, KEGG, MetaCyc), disease associations, enzyme/gene linkage. Use for metabolite-to-pathway-to-disease connections, BridgeDb-based ID conversion, and integrating metabolomics with gene-level pathway analyses.
disable-model-invocation: true
---

# Metabolomics Pathway Analysis

Identify metabolites, map to metabolic pathways, find disease associations, and connect to enzymes/genes.

## Domain Reasoning

Metabolite-to-pathway mapping requires correct, database-specific identifiers. HMDB IDs link to KEGG/Reactome but must be converted via BridgeDb; PubChem CIDs need explicit cross-referencing. Always verify metabolite identity first: the same common name can refer to structurally distinct isomers, and PubChem names frequently differ from CTD/KEGG names.

## LOOK UP DON'T GUESS

- Pathway membership: call `MetaCyc_get_compound`, `KEGG_get_compound`, or `ReactomeContent_search`
- Cross-database IDs: use `BridgeDb_xrefs`
- Enzyme-metabolite relationships: use `CTD_get_chemical_gene_interactions` or `KEGG_get_compound`
- Disease associations: query `Metabolite_get_diseases` or `CTD_get_chemical_diseases`

---

## COMPUTE, DON'T DESCRIBE
When analysis requires computation (statistics, data processing, scoring, enrichment), write and run Python code via Bash. Don't describe what you would do — execute it and report actual results. Use ToolUniverse tools to retrieve data, then Python (pandas, scipy, statsmodels, matplotlib) to analyze it.

## Workflow

```
Phase 0: Identify & Resolve → Phase 1: Characterize → Phase 2: Pathway Map →
Phase 3: Enzyme/Gene Linkage → Phase 4: Disease Associations → Phase 5: Cross-DB Enrichment → Report
```

---

## Phase 0: Metabolite Identification & Resolution

### By Name
**Metabolite_search**: `query` (REQUIRED), `search_type` ("name"/"formula"). Returns PubChem matches with CID, name, formula, MW, SMILES.
**MetabolomicsWorkbench_search_compound_by_name**: `name` (REQUIRED). Cross-reference with RefMet.

### By Mass/Formula
**MetabolomicsWorkbench_search_by_mz**: `mz` (REQUIRED), `adduct` (e.g., "M+H"), `tolerance`. Uses moverz/REFMET/{mz}/{adduct}/{tolerance}.
**MetabolomicsWorkbench_search_by_exact_mass**: `exact_mass` (REQUIRED), `tolerance`. Uses moverz/REFMET/{mass}/M/{tolerance}.

### By ID
**Metabolite_get_info**: `compound_name`, `hmdb_id` (e.g., "HMDB0000122"), or `pubchem_cid`. Returns HMDB ID, CID, InChIKey, classification.
**KEGG_get_compound**: `compound_id` (e.g., "C00031"). Returns linked pathways, enzymes, reactions.

### ID Cross-Referencing
**BridgeDb_xrefs**: `identifier` (REQUIRED), `source` (REQUIRED: "Ch"=HMDB, "Cs"=ChemSpider, "Ck"=KEGG, "Ce"=ChEBI), `target` (optional).
**BridgeDb_search**: `query` (REQUIRED), `organism`. Free-text metabolite search.

---

## Phase 1: Metabolite Characterization

**Metabolite_get_info**: classification (super_class/class/sub_class), biological_roles, cellular_locations.
**MetabolomicsWorkbench_get_refmet_info**: `refmet_name` (REQUIRED). Standardized RefMet classification.
**KEGG_get_compound**: linked enzyme/reaction/pathway IDs.

---

## Phase 2: Pathway Mapping

### MetaCyc
- `MetaCyc_search_pathways`: `query` (keyword search, e.g., "glycolysis")
- `MetaCyc_get_pathway`: `pathway_id` (e.g., "GLYCOLYSIS") -- reactions, enzymes, compounds
- `MetaCyc_get_compound`: `compound_id` (e.g., "PYRUVATE") -- pathways it participates in
- `MetaCyc_get_reaction`: `reaction_id` -- substrates, products, enzymes

### KEGG
- `KEGG_get_gene_pathways`: `gene_id` (e.g., "hsa:5230") -- pathways for enzyme gene
- `KEGG_get_pathway_genes`: `pathway_id` (e.g., "hsa00010") -- all genes in pathway

### Reactome
- `ReactomeContent_search`: `query`, `types` (e.g., "Pathway"), `species`
- `Reactome_get_pathway`: `id` (e.g., "R-HSA-70171")
- `ReactomeAnalysis_pathway_enrichment`: `identifiers` (space-separated string, NOT array)
- `Reactome_map_uniprot_to_pathways`: `uniprot_id`

---

## Phase 3: Enzyme & Gene Linkage

**CTD_get_chemical_gene_interactions**: `input_terms` (chemical name). Returns interacting genes.
**KEGG_get_gene_pathways**: which pathways an enzyme gene participates in.
**BridgeDb_attributes**: `identifier`, `source`, `organism`. Get attributes for identifier.

Workflow: KEGG compound -> enzyme IDs -> MetaCyc reaction -> enzyme names -> Reactome uniprot -> pathways -> MyGene for gene info.

---

## Phase 4: Disease Associations

**CTD_get_chemical_diseases**: `input_terms` (chemical name, MeSH, CAS RN). Curated associations with direct/inferred evidence.
**CTD_get_gene_diseases**: `input_terms` (gene name). For metabolite-processing genes from Phase 3.
**Metabolite_get_diseases**: `compound_name`/`hmdb_id`/`pubchem_cid`, `limit` (default 50). CTD-backed.

---

## Phase 5: Cross-Database Enrichment

**MetabolomicsWorkbench_get_study**: `study_id` (e.g., "ST000001").
**MetabolomicsWorkbench_get_compound_by_pubchem_cid**: `pubchem_cid`.
**PubMed_search_articles** / **EuropePMC_search_articles**: literature context.

For metabolite list enrichment: (1) convert names to gene/enzyme IDs via CTD, (2) run `ReactomeAnalysis_pathway_enrichment` with space-separated identifiers, (3) use `KEGG_get_gene_pathways` per enzyme.

---

## Common Mistakes to Avoid

| Mistake | Correction |
|---------|-----------|
| Array to ReactomeAnalysis_pathway_enrichment | Must be space-separated string |
| HMDB IDs in CTD_get_chemical_diseases | CTD uses common names or MeSH IDs |
| Not resolving names first | Always start with Metabolite_search |
| gene_id without organism prefix for KEGG | Need "hsa:5230" not "5230" |
| Expecting HMDB API | No open API; use Metabolite_get_info (PubChem-backed) |
| PubChem title to CTD when names differ | Try both PubChem name and common synonyms |
| MetabolomicsWorkbench exactmass | Use moverz/REFMET/{mass}/M/{tolerance} (exactmass broken) |

---

## Fallback Strategies

- **Metabolite_search empty** -> MetabolomicsWorkbench_search_compound_by_name or KEGG_get_compound
- **MetaCyc not found** -> KEGG or Reactome pathways
- **CTD empty for disease** -> Metabolite_get_diseases with HMDB/CID
- **No KEGG compound ID** -> BridgeDb_xrefs from HMDB/ChEBI
- **exactmass fails** -> search_by_mz with M+H adduct
- **Need enzyme genes** -> CTD_get_chemical_gene_interactions

---

## Evidence Grading

| Tier | Criteria | Sources |
|------|----------|---------|
| **T1** | Curated disease association, direct evidence | CTD curated, OMIM |
| **T2** | Multiple database pathway concordance | MetaCyc + KEGG + Reactome agreement |
| **T3** | Inferred or single-database | CTD inferred, single pathway DB |
| **T4** | Computational prediction or text-mining | Literature, RefMet classification |

---

## Limitations

- HMDB has no open API; use Metabolite_get_info (PubChem-backed).
- MetaCyc pathways are reference (not organism-specific like KEGG).
- CTD can return very large sets for common metabolites (22K+ for acetaminophen).
- ReactomeAnalysis expects gene/protein IDs, not metabolite IDs directly.
- BridgeDb coverage depends on the metabolite being in mapping databases.

© mims-harvard · Apache-2.0 · mims-harvard/ToolUniverse

Similar skills

All skills for Science and research →

From the same set136

The whole set →
tooluniverse-protein-modification-analysis tooluniverse-protein-modification-analysis is a Claude Code skill for studying protein post-translational modifications. It handles PTM site annotation, enzyme links, and disease associations. CX Codex +1 239installs tooluniverse-pathway-disease-genetics tooluniverse-pathway-disease-genetics traces GWAS variants through causal genes and biological pathways to drug targets. Use it to study disease mechanisms or prioritize repurposing candidates. CX Codex +1 239installs tooluniverse-lipidomics tooluniverse-lipidomics is a Claude Code skill that identifies and classifies lipids, maps metabolic pathways, and retrieves disease associations for lipidomics analysis. CX Codex +1 238installs tooluniverse-comparative-genomics tooluniverse-comparative-genomics is a Claude Code skill that finds orthologs and assesses gene conservation across species. CX Codex +1 238installs tooluniverse-electron-microscopy The tooluniverse-electron-microscopy skill for Claude Code searches and inspects electron microscopy records in EMDB, PDB, EMPIAR, and CryoET Data Portal. It helps link density maps to fitted atomic models. CX Codex +1 238installs tooluniverse-adverse-outcome-pathway tooluniverse-adverse-outcome-pathway maps industrial and environmental chemicals to adverse outcome pathways. Retrieves GHS classifications, IARC cancer statuses, LD50 toxicity values, and CTD gene interactions. CX Codex +1 236installs tooluniverse-model-organism-genetics tooluniverse-model-organism-genetics is a Claude Code skill for comparing human genes with model organisms, mapping orthologs and retrieving phenotype and expression data. CX Codex +1 235installs tooluniverse-kegg-disease-drug tooluniverse-kegg-disease-drug is a Claude Code skill that links diseases to genes, drugs to targets and variants to pathways via KEGG. It activates on keywords like KEGG disease, drug targets or variant networks. CX Codex +1 235installs

Project sponsors

Companies that keep this analytics open