Skip to main content
skill CX Codex

tooluniverse-metagenomics-analysis — Claude Code skill

tooluniverse-metagenomics-analysis is a Claude Code skill for exploring microbiome studies with MGnify, GTDB, ENA, and research literature.

Apache-2.0 256 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-metagenomics-analysis -a claude-code
Open on GitHub

What tooluniverse-metagenomics-analysis does

The skill guides analysis from study discovery to biological interpretation. It uses MGnify and ENA to locate studies, GTDB to classify taxa, and GMrepo and publications to examine clinical links. Genome assessment considers completeness and contamination, while pathway results are tied to biological meaning rather than left as a list of terms.

For computation, the skill calls for running Python through Bash and checking scientific claims against databases. ENA searches need structured queries rather than free text. It does not process raw FASTQ or FASTA files; it queries databases instead. GTDB covers bacteria and archaea, while GMrepo focuses on gut data.

What it helps with

  • find microbiome studies by organism, biome, or phenotype
  • reconcile GTDB taxon names with NCBI naming
  • grade genome quality using completeness and contamination
  • interpret microbial functions through KEGG pathways
  • support clinical links with literature and evidence grades

Example prompts for the agent

  • Analyze gut microbiome studies related to Crohn disease and connect taxa with clinical findings.
  • Assess the genomes in this study using MIMAG quality tiers.
  • Interpret the microbiome's functional annotations in relation to the biological question.

How to install tooluniverse-metagenomics-analysis

1Skills CLI (Vercel)

npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metagenomics-analysis -a claude-code

2Manually: put the files in place

~/.claude/skills/tooluniverse-metagenomics-analysis/SKILL.md

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

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

Questions about tooluniverse-metagenomics-analysis

How do I install tooluniverse-metagenomics-analysis in Claude Code?

Run npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metagenomics-analysis -a claude-code. The skill file is at ~/.claude/skills/tooluniverse-metagenomics-analysis/SKILL.md.

What does tooluniverse-metagenomics-analysis do?

It supports microbiome study discovery, taxonomic classification, genome quality assessment, and interpretation of pathways and clinical associations.

Can this skill analyze FASTQ files?

No. It retrieves and analyzes database records; it does not process raw FASTQ or FASTA sequences.

Source text

SKILL.md · Apache-2.0
---
name: tooluniverse-metagenomics-analysis
description: Microbiome and metagenomics analysis using MGnify, GTDB taxonomy, ENA sequencing data, and EuropePMC literature. Covers taxonomic classification, genome quality assessment, biome-clinical phenotype linkage, and pathway interpretation. Use for amplicon/shotgun metagenomics study analysis.
disable-model-invocation: true
---

# Metagenomics & Microbiome Analysis

Integrated pipeline for exploring microbiome studies, classifying taxa, assessing genome quality, linking microbial composition to clinical phenotypes, and interpreting findings through pathway analysis and literature context.

**Guiding principles**:
1. **Study context first** -- understand biome, sequencing method, and metadata before diving into taxa
2. **Taxonomic consistency** -- GTDB taxonomy as reference standard; reconcile NCBI where needed
3. **Genome quality matters** -- CheckM completeness/contamination thresholds determine trustworthy MAGs
4. **Interpretation over enumeration** -- explain what taxa mean for the biological question
5. **English-first queries** -- use English terms in tool calls

## LOOK UP, DON'T GUESS
When uncertain about any scientific fact, SEARCH databases first rather than reasoning from memory.

---

## 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.

## Core Databases

| Database | Best For |
|----------|---------|
| **MGnify** | Processed metagenomics studies, taxonomic/functional results |
| **GTDB** | Standardized bacterial/archaeal taxonomy, species-level resolution |
| **GMrepo** | Gut species-to-human-health phenotype associations |
| **ENA** | Raw sequencing datasets and study metadata |
| **KEGG** | Pathway mapping for microbial functional annotations |
| **PubMed/EuropePMC** | Published microbiome-disease studies |
| **CTD** | Chemical-microbiome-disease relationships |

---

## Workflow

```
Phase 0: Parse query → organism, biome, phenotype, or accession
Phase 1: Study Discovery → MGnify_search_studies, ENAPortal_search_studies
Phase 2: Taxonomic Classification → GTDB_search_genomes, GTDB_get_species, GTDB_search_taxon
Phase 3: Genome Quality → MGnify_search_genomes, MGnify_get_genome (CheckM metrics)
Phase 4: Functional Annotation → MGnify GO terms + KEGG pathway mapping
Phase 5: Clinical Associations → GMrepo species-phenotype links
Phase 6: Literature → PubMed/EuropePMC + CTD gene-disease
Phase 7: Interpretation & Report Synthesis
```

---

## Key Phase Notes

**Phase 1**: ENA requires structured queries (e.g., `study_title="*IBD*"`), not free text. If ENA fails, fall back to MGnify.

**Phase 2**: GTDB uses its own naming (e.g., `s__Bacteroides_A fragilis` vs NCBI `Bacteroides fragilis`). Always note discrepancies. Use `GTDB_search_taxon(operation="search_taxon", query=name)`.

**Phase 3 - Quality tiers** (MIMAG):
- **High**: >= 90% complete, <= 5% contamination, rRNA + >= 18 tRNAs
- **Medium**: >= 50% complete, <= 10% contamination
- **Low**: below medium -- flag but don't exclude

**Phase 4 - Functional interpretation**: Don't just list GO terms. Connect to biology:

| Functional Category | Key KEGG Pathways | Significance |
|---|---|---|
| SCFA production | map00650, map00640 | Gut barrier, anti-inflammatory |
| LPS biosynthesis | map00540 | Pro-inflammatory, endotoxemia |
| Bile acid metabolism | map00120 | Fat absorption, FXR signaling |
| Tryptophan metabolism | map00380 | Serotonin, AhR, immune |
| Vitamin biosynthesis | map00730/740/760 | Host nutritional contribution |

Use `kegg_search_pathway(keyword=...)` (NOT `query`). Pathway IDs need organism prefix (`hsa`, `ko`, `eco`), NOT bare `map`.

**Phase 5**: GMrepo uses MeSH terms: "Crohn Disease" not "IBD", "Colitis, Ulcerative" not "UC", "Colorectal Neoplasms" not "colorectal cancer". Try NCBI taxon IDs if species name fails.

**Phase 6 - Evidence grading**:
- **Strong**: Meta-analysis or >5 studies, consistent direction
- **Moderate**: 2-5 studies consistent, or 1 large cohort
- **Preliminary**: Single study or conflicting
- **Mechanistic only**: In vitro/animal, no human epidemiology

**Phase 7 - Report**: Executive summary, study landscape, GTDB taxonomy, functional interpretation (not GO term lists), clinical relevance with evidence grades, mechanistic model, genome catalog with quality tiers, data gaps.

---

## Edge Cases & Fallbacks

- **Taxon not in GTDB**: Try partial search or fall back to MGnify (NCBI taxonomy)
- **No GMrepo data**: Normal for non-gut organisms; use literature
- **GMrepo 0 results**: Use formal MeSH terms or NCBI taxon IDs
- **No KEGG match**: Check MetaCyc or literature

## Limitations

- **GMrepo**: Gut-only
- **GTDB**: Bacteria/Archaea only
- **ENA**: Raw data only, strict query syntax
- **No sequence analysis**: Queries databases, not raw FASTQ/FASTA

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

Similar skills

All skills for Science and research →

From the same set136

The whole set →
tooluniverse-drug-regulatory tooluniverse-drug-regulatory — a skill that walks an agent through drug approval checks: FDA and EMA status, generics, patents, exclusivity, ATC classes and label sections. CX Codex +1 261installs tooluniverse-epidemiological-analysis The tooluniverse-epidemiological-analysis skill takes observational epidemiology from a PECO question to a statistical report, generating Python code for the analysis. CX Codex +1 258installs tooluniverse-ecology-biodiversity tooluniverse-ecology-biodiversity — a skill for ecology and biodiversity research: species identification via GBIF and NCBI, invasive species impact assessment, IUCN conservation status, population dynamics, and food web analysis. CX Codex +1 257installs tooluniverse-immunology tooluniverse-immunology is a Claude Code skill for immunology research, covering antibody-antigen binding, T/B cell repertoires, and epitope mapping via IEDB, SAbDab, and IMGT. CX Codex +1 256installs tooluniverse-dataset-discovery tooluniverse-dataset-discovery is a Claude Code skill that finds research datasets and checks study designs and variables for scientific questions. CX Codex +1 254installs tooluniverse-toxicology tooluniverse-toxicology builds a toxicity picture for a drug or chemical: AOP mechanism, FAERS signals, FDA label warnings, CTD associations, EPA CompTox hazard data. CX Codex +1 250installs tooluniverse-drug-mechanism-research The tooluniverse-drug-mechanism-research skill follows a drug from its primary target through pathway changes to clinical outcomes. Use it for pharmacology research, target comparisons, and mechanism reports. CX Codex +1 250installs tooluniverse-regulatory-genomics tooluniverse-regulatory-genomics queries regulatory elements, transcription factor binding motifs, and predicts non-coding variant effects using genomic databases and deep learning models. CX Codex +1 247installs

Project sponsors

Companies that keep this analytics open