pku-embl/metagenomics-skills/biobakery-databases

Claude Code and agent skill by pku-embl/metagenomics-skills

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Install and pin bioBakery reference databases for MetaPhlAn and HUMAnN (ChocoPhlAn markers, UniRef gene families, MetaCyc pathways, utility mapping). Use this skill when: (1) Downloading MetaPhlAn/HUMAnN databases, (2) Choosing UniRef90 vs UniRef50, (3) Aligning MetaPhlAn and HUMAnN DB versions, (4) Troubleshooting missing index paths. For Kraken indexes use kraken2. For eggNOG/CARD/GTDB use those skills.

Install

npx vskill@latest install pku-embl/metagenomics-skills/biobakery-databases

SKILL.md

bioBakery databases (MetaPhlAn / HUMAnN)

Upstream: MetaPhlAn · HUMAnN · bioBakery: https://huttenhower.sph.harvard.edu/biobakery/

Analytical thinking

MetaPhlAn and HUMAnN results are database-version-dominated. Changing ChocoPhlAn or UniRef releases can move species/pathway tables more than tweaking CLI flags.

Keep MetaPhlAn marker DB and HUMAnN nucleotide/protein DBs compatible for the same study when you report both taxonomy and pathways. Record: software version + DB names + install paths + download date.

UniRef90 vs UniRef50 is a sensitivity/specificity and disk trade-off — state it explicitly; do not silently switch mid-cohort.

Prerequisites

DBUsed byNotes
MetaPhlAn / ChocoPhlAn markersmetaphlanSpecies-level marker genes
HUMAnN ChocoPhlAnhumannNucleotide mapping
UniRef90 or UniRef50humannTranslated search / gene families
Utility mapping + MetaCychumannPathway aggregation

Disk: tens to hundreds of GB depending on UniRef choice.

How to install (HUMAnN helpers)

Run large downloads only after checking free space, network policy, and bundle names against the installed helper.

bash
set -Eeuo pipefail
root="${1:?usage: install-humann-dbs.sh NEW_DATABASE_ROOT}"
log_dir="${root}.logs"
test ! -e "$root" && test ! -e "$log_dir" || {
  echo "use new database and log paths" >&2; exit 2;
}
mkdir -p "$root" "$log_dir"
humann_databases --download chocophlan full "$root" \
  >"$log_dir/chocophlan.stdout.log" 2>"$log_dir/chocophlan.stderr.log"
humann_databases --download uniref uniref90_diamond "$root" \
  >"$log_dir/uniref.stdout.log" 2>"$log_dir/uniref.stderr.log"
humann_databases --download utility_mapping full "$root" \
  >"$log_dir/utility.stdout.log" 2>"$log_dir/utility.stderr.log"
 
humann_config --update database_folders nucleotide "$root/chocophlan"
humann_config --update database_folders protein "$root/uniref"
humann_config --update database_folders utility_mapping "$root/utility_mapping"
find "$root" -type f -size +0c -print | sort >"$root/files.manifest"

These are HUMAnN 3 helper interfaces; capture humann_databases --help, package version, downloaded bundle names and checksums before configuring paths.

How to install (MetaPhlAn)

bash
set -Eeuo pipefail
root="${1:?usage: install-metaphlan-db.sh NEW_DATABASE_ROOT}"
log_dir="${root}.logs"
test ! -e "$root" && test ! -e "$log_dir" || {
  echo "use new database and log paths" >&2; exit 2;
}
mkdir -p "$root" "$log_dir"
metaphlan --install --db_dir "$root" \
  >"$log_dir/install.stdout.log" 2>"$log_dir/install.stderr.log"
find "$root" -type f -size +0c -print | sort >"$root/files.manifest"
test -s "$root/files.manifest"

Confirm the DB build string printed in MetaPhlAn logs and archive it.

Decision tree

text
Profiling DB need?
├─ Marker taxonomy only → MetaPhlAn DB (this skill) → metaphlan
├─ Pathways / gene families → HUMAnN DBs (this skill) → humann
├─ Custom / fast k-mer taxonomy → kraken2 indexes (not bioBakery)
└─ Genome taxonomy for MAGs → gtdb / gtdbtk

Verify, recovery, and provenance

bash
set -Eeuo pipefail
root="${1:?usage: verify-biobakery-db.sh DATABASE_ROOT}"
test -d "$root" && test -s "$root/files.manifest" || exit 2
metaphlan --version
humann --version
humann_config --print
find "$root" -type f -size 0 -print >"$root/empty-files.txt"
test ! -s "$root/empty-files.txt"
sha256sum "$root/files.manifest" >"$root/files.manifest.sha256"

Inspect helper logs, expected index shards, bundle/readme metadata, configured paths, and a small tool-provided test before cohort use. Interrupted downloads must be resumed only through supported helpers or moved aside; never combine unknown partial bundles. Record software/helper versions, exact bundle/index names, UniRef level, URLs, download date, file manifest/checksums, configuration, and storage path. A database install is not validated merely because files exist.

Related skills

public-databases · metaphlan · humann · kraken2 · setup

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
6
7-day trend score
10

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/pku-embl/metagenomics-skills/biobakery-databases/badge)](https://verified-skill.com/skills/pku-embl/metagenomics-skills/biobakery-databases)

Something wrong with this skill or its page? Tell us.