tooluniverse-lipidomics
The tooluniverse-lipidomics skill integrates LIPID MAPS classification, HMDB metabolite data, and KEGG/Reactome pathways to identify lipids, map their metabolic roles, and associate them with diseases. Use it to classify lipids by structure and chemical category, trace their biosynthesis and degradation routes across sphingolipid, eicosanoid, steroid, and fatty acid pathways, and discover lipid biomarkers for cardiovascular disease, diabetes, neurodegeneration, and metabolic syndrome.
git clone --depth 1 https://github.com/mims-harvard/ToolUniverse /tmp/tooluniverse-lipidomics && cp -r /tmp/tooluniverse-lipidomics/plugin/skills/tooluniverse-lipidomics ~/.claude/skills/tooluniverse-lipidomicsSKILL.md
# Lipidomics Analysis
Integrated pipeline for lipid identification, classification, pathway mapping, and disease association analysis. Distinct from general metabolomics because lipids have unique classification systems (LIPID MAPS), specialized pathways (sphingolipid, eicosanoid, steroid), and disease associations (cardiovascular, neurodegeneration, metabolic syndrome).
## Reasoning Strategy
Lipid identification starts with mass spectrometry: the lipid class is determined by the head group fragment mass (e.g., m/z 184 for phosphocholine in positive mode), total chain length and saturation from the precursor exact mass, and individual fatty acid chains from neutral loss or product ion scans. LIPID MAPS classification organizes lipids by chemical structure into 8 categories — knowing the category immediately tells you the likely biological context (sphingolipids → apoptosis/neurodegeneration; glycerophospholipids → membrane remodeling; eicosanoids → inflammation). Structural specificity matters biologically: Cer(d18:1/16:0) and Cer(d18:1/24:1) have different membrane properties and disease associations despite being the same lipid class. Always map changed lipids back to metabolic pathways because lipids are intermediates — an elevated ceramide could mean increased synthesis (CERS activity up), decreased degradation (ASAH1 down), or shunting from sphingomyelin (SMPD1 up).
**LOOK UP DON'T GUESS**: Do not assume a lipid's LIPID MAPS ID, exact mass, or pathway membership — query `LipidMaps_search_by_name` first. Do not guess which diseases are associated with a lipid class; retrieve them from HMDB or CTD.
**Key principles**:
1. **LIPID MAPS classification first** — use the 8-category system (fatty acyls, glycerolipids, glycerophospholipids, sphingolipids, sterol lipids, prenol lipids, saccharolipids, polyketides)
2. **Structural specificity matters** — chain length, unsaturation, and sn-position affect biological function
3. **Connect to pathways** — lipids are metabolic intermediates; always map to biosynthesis/degradation pathways
4. **Disease context** — many lipids are disease biomarkers (sphingolipids in neurodegeneration, oxidized lipids in CVD)
5. **Evidence grading** — T1: clinical biomarker studies, T2: mechanistic studies, T3: association data, T4: computational prediction
---
## When to Use
- "Identify this lipid species from m/z and retention time"
- "What pathways involve ceramide/sphingomyelin?"
- "Lipid biomarkers for Alzheimer's disease"
- "What diseases are associated with altered sphingolipid metabolism?"
- "Map my lipidomics results to KEGG pathways"
- "Compare lipid profiles between conditions"
**Not this skill**: For general metabolomics (amino acids, sugars, organic acids), use `tooluniverse-metabolomics`. For drug ADMET properties, use `tooluniverse-admet-prediction`.
---
## Core Tools
| Tool | Use For |
|------|---------|
| `LipidMaps_search_by_name` | Lipid identification by name, abbreviation, or mass |
| `LipidMaps_get_compound_by_id` | Detailed lipid info (structure, classification, pathways) |
| `HMDB_search` / `HMDB_get_metabolite` | Lipid metabolite details, disease associations |
| `kegg_search_pathway` | Lipid metabolism pathways (keyword=`sphingolipid`, `glycerolipid`, etc.) |
| `KEGG_get_pathway_genes` | Enzymes in lipid pathways |
| `PubChem_get_compound_properties_by_CID` | Chemical properties (mass, formula, SMILES) |
| `CTD_get_gene_diseases` | Gene-disease links for lipid metabolism enzymes |
| `DisGeNET_search_gene` | Disease associations for lipid genes |
| `PubMed_search_articles` | Published lipidomics studies |
| `OpenTargets_get_associated_drugs_by_target_ensemblID` | Drugs targeting lipid metabolism enzymes |
---
## Workflow
```
Phase 0: Lipid Identity Resolution
Name/mass/abbreviation → LIPID MAPS ID → classification
|
Phase 1: Structural Classification
LIPID MAPS 8-category system → subclass → molecular species
|
Phase 2: Pathway Mapping
KEGG lipid metabolism → biosynthesis/degradation enzymes
|
Phase 3: Disease Associations
CTD/DisGeNET/HMDB → lipid-disease links with evidence
|
Phase 4: Interpretation & Report
Biological significance → biomarker potential → recommendations
```
### Phase 0: Lipid Identity Resolution
```
LipidMaps_search_by_name(query="ceramide") → LMSP ID, exact mass, classification
HMDB_search(compound_name="ceramide") → HMDB ID, disease links
PubChem_get_CID_by_compound_name(name="ceramide") → CID, SMILES
```
**LIPID MAPS search tips**:
- Generic names work well: "ceramide", "sphingomyelin", "phosphatidylcholine"
- Species-level abbreviations like "Cer(d18:1/16:0)" may return 0 results — use the generic class name first, then filter by chain length from results
- For exact mass search: use `LipidMaps_search_by_formula` with molecular formula (e.g., "C34H67NO3")
- If name search fails, try PubChem: `PubChem_get_CID_by_compound_name(name="C16 Ceramide")` then cross-reference
### Phase 1: Structural Classification
Use `LipidMaps_get_compound_by_id` to retrieve the LIPID MAPS 8-category classification (FA, GL, GP, SP, ST, PR, SL, PK) for any lipid. The category immediately signals biological context: SP (sphingolipids) → apoptosis/neurodegeneration; GP (glycerophospholipids) → membrane remodeling; FA-derived eicosanoids → inflammation.
### Phase 2: Pathway Mapping
Key lipid metabolism pathways in KEGG:
| Pathway | KEGG ID | Key Enzymes | Disease Relevance |
|---------|---------|-------------|-------------------|
| Sphingolipid metabolism | hsa00600 | SMPD1, CERS1-6, ASAH1 | Niemann-Pick, Fabry, Gaucher |
| Glycerophospholipid metabolism | hsa00564 | PLA2, LPCAT, LPIN | Barth syndrome, atherosclerosis |
| Arachidonic acid metabolism | hsa00590 | COX1/2, LOX, CYP450 | Inflammation, asthma, CVD |
| Steroid biosynthesis | hsa00100 | HMGCR, CYP51A1, DHCR7 | Hypercholesterolemia, Smith-Lemli-Opitz |
| Fatty acid biosynthesis | hsa00061 | FASN, ACC, SCD | Obesity, NAFLD, cancerInstall and configure ToolUniverse for any use case — MCP server (chat-based), CLI (command line with 9 subcommands), or Python SDK (Coding API with 3 calling patterns). Covers uv/uvx setup, MCP configuration for 12+ AI clients (Cursor, Claude Desktop, Windsurf, VS Code, Codex, Gemini CLI, Trae, Cline, etc.), full CLI reference (tu list/grep/find/info/run/test/status/build/serve), Coding API quickstart, agentic tools, code executor, API key walkthrough, skill installation, and upgrading. Use when user asks how to set up ToolUniverse, which access mode to use (MCP vs CLI vs SDK), configuring MCP servers, using the CLI, troubleshooting installation, upgrading, or mentions installing ToolUniverse or setting up scientific tools. Also triggers for "how do I use ToolUniverse", "what's the best way to access tools", "command line", "tu command", "coding API", "tu build".
Systematic ACMG/AMP germline variant classification with all 28 criteria (PVS1, PS1-4, PM1-6, PP1-5, BA1, BS1-4, BP1-7) for clinical significance. Produces 5-tier verdict (Pathogenic / Likely Pathogenic / VUS / Likely Benign / Benign) with cited evidence per criterion. Use for variant interpretation, VUS resolution, and pathogenicity assessment. Combines ClinVar, gnomAD, computational predictors, and gene-mechanism context.
Comprehensive ADMET (Absorption, Distribution, Metabolism, Excretion, Toxicity) profiling for drug candidates. Integrates ADMET-AI predictions, SwissADME drug-likeness, PubChemTox experimental toxicity, ChEMBL clinical data, Lipinski rule-of-five, and CYP interaction data. Use for drug-likeness assessment, BBB penetration, bioavailability, hepatotoxicity prediction, ADME/PK profiling, or screening compound libraries before lab testing.
Detect and analyze adverse drug event signals using FDA FAERS reports, drug labels, and disproportionality statistics (PRR, ROR, IC). Generates quantitative safety signal scores (0-100) with evidence grading. Use for post-market surveillance, pharmacovigilance, drug safety assessment, regulatory submissions, and detecting rare AE signals not visible in clinical trials.
Map environmental and industrial chemicals to adverse outcome pathways (AOPs) — molecular initiating event to organ-level toxicity. Uses AOPWiki, GHS classification, IARC carcinogen status, and LD50 data. Use for environmental/industrial chemical risk assessment, regulatory-grade hazard characterization, and AOP stressor mapping. Distinct from drug-safety analysis (use tooluniverse-pharmacovigilance for drugs).
Aging biology, cellular senescence, and longevity research. Covers senescence markers (p16/CDKN2A, SASP, SA-beta-gal), aging hallmarks, senolytic drug discovery (dasatinib+quercetin, fisetin, navitoclax), epigenetic clocks, telomere biology, and longevity GWAS. Use for senescence-pathway analysis, age-related disease genetics, senolytic-target discovery, and centenarian-genetics queries. Distinguishes correlative vs causal evidence (knockout, intervention).
Therapeutic antibody engineering and optimization, lead-to-clinical-candidate. Covers sequence humanization (germline alignment, framework retention), affinity maturation, developability (aggregation, stability, PTMs), structure modeling (AlphaFold/PDB CDR analysis), immunogenicity prediction, and manufacturing feasibility. Use for biologic-drug optimization, mAb design review, biosimilar engineering, and clinical-precedent comparison.
Discover novel small-molecule binders for protein targets using structure-based and ligand-based screening. Covers druggability assessment, known-ligand mining (ChEMBL, BindingDB), similarity expansion, ADMET filtering, and synthesis feasibility. Use for hit identification, virtual screening, target-to-compounds workflows, and lead-finding before commit-to-medchem.