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
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metagenomics-analysis -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/tooluniverse-metagenomics-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tooluniverse-metagenomics-analysis/
1Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metagenomics-analysis -a codex2Manually: put the files in place
.agents/skills/tooluniverse-metagenomics-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metagenomics-analysis -a cursor2Manually: put the files in place
.cursor/skills/tooluniverse-metagenomics-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mims-harvard/ToolUniverse skills/tooluniverse-metagenomics-analysis2Manually: put the files in place
.github/skills/tooluniverse-metagenomics-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metagenomics-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/mims-harvard/ToolUniverse --path skills/tooluniverse-metagenomics-analysisManually: put the files in place
.devin/skills/tooluniverse-metagenomics-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-metagenomics-analysis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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