ngs-shotgun-metagenomics

Runs shotgun metagenomics QC, host depletion, and taxonomic and functional profiling workflows.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill ngs-shotgun-metagenomics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ngs-shotgun-metagenomics
Source: https://github.com/openai/plugins/tree/main/plugins/ngs-analysis/skills/ngs-shotgun-metagenomics
Command: npx skills add https://github.com/openai/plugins --skill ngs-shotgun-metagenomics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up shotgun metagenomics analysis requires coordinating many tools, large reference databases, and host-depletion decisions, and mistakes in any of these steps can silently invalidate taxonomic or functional conclusions. This Skill structures the entire workflow from FASTQ intake through profiling so nothing critical is skipped.

Core Features & Use Cases

  • Preflight and FASTQ QC: Validates sample sheets and read structure, runs seqkit stats and FastQC/MultiQC, and records tool or database blockers explicitly.
  • Taxonomic and Functional Profiling: Orchestrates Kraken2, Bracken, MetaPhlAn, HUMAnN, and KneadData host depletion, or launches nf-core/taxprofiler for reproducible pipeline execution.
  • Visualization Outputs: Generates read-QC dashboards, Bracken abundance matrices, HUMAnN pathway tables, and HTML/SVG review bundles.
  • Use Case: A researcher with paired-end human gut metagenomic FASTQs needs host-depleted taxonomic profiles and pathway abundances; the Skill validates inputs, runs KneadData plus Kraken2/Bracken/HUMAnN, and produces a review dashboard.

Quick Start

Ask the assistant to inspect your shotgun metagenomic FASTQs, confirm host-depletion and database choices, and run the profiling preflight for your sample sheet.

Frequently Asked Questions about ngs-shotgun-metagenomics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run taxonomic profiling on shotgun metagenomics FASTQ files?

Use the run_shotgun_metagenomics.py script with a sample sheet and a Kraken2 database path to execute Kraken2 classification, optionally adding Bracken abundance estimation with --run-bracken. Alternatively, run nf-core/taxprofiler via run_nfcore_pipeline.py for a reproducible pipeline execution.

Kraken2 vs MetaPhlAn vs HUMAnN for metagenomics analysis?

Kraken2 with Bracken provides k-mer-based taxonomic classification and abundance estimation, MetaPhlAn offers marker-gene-based profiling, and HUMAnN quantifies functional pathways and gene families. The Skill supports all three and recommends nf-core/taxprofiler when you want a reproducible multi-tool workflow.

Does the workflow support host DNA depletion for human samples?

Yes, supplying --host-reference to the backend runner adds a KneadData host-depletion step that writes cleaned FASTQs under host_depletion/ and uses them for downstream Kraken2 and HUMAnN steps. The host reference choice is documented because it can change taxonomic and functional conclusions.

What happens if Kraken2 or HUMAnN databases are not installed?

The FASTQ intake package still runs read QC and writes a visualization bundle, but it records the missing database or tool as an explicit blocker in taxonomic_classification_status.json. Summary layers are marked not_available rather than implying profiling succeeded.

Can I run nf-core/taxprofiler without local databases?

You can kick off a preflight test run with nextflow using the test and docker profiles, which validates the pipeline setup. Real analysis still requires appropriate reference databases, and large database downloads should be confirmed for size and destination first.