ngs-amplicon-microbiome

Runs 16S, 18S, ITS, and COI amplicon microbiome analysis with nf-core/ampliseq, QIIME2, and DADA2.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Marker-gene microbiome studies require coordinating primer trimming, ASV inference, taxonomy assignment, and diversity analysis across multiple bioinformatics tools, and misconfigured primers or taxonomy databases silently invalidate results. This Skill structures that workflow so amplicon FASTQs become auditable ASV tables, taxonomy assignments, and diversity metrics.

Core Features & Use Cases

  • Read QC and Readiness Packaging: Validates sample sheets, runs seqkit stats and FastQC/MultiQC, and emits machine-readable QC verdicts and visualization dashboards before any backend run.
  • Multi-Backend ASV and Taxonomy Execution: Runs QIIME2, DADA2 (via Rscript), or nf-core/ampliseq with explicit primer sequences, truncation choices, and taxonomy classifiers, producing normalized ASV tables, representative sequences, and read-retention reports.
  • Diversity and Visualization Outputs: Generates alpha diversity, Bray-Curtis distances, PCoA, rarefaction, and taxa barplots when feature tables exist, and blocks unsupported claims when they do not.
  • Use Case: A researcher with paired-end 16S V4 FASTQs provides primer sequences, a SILVA 138 classifier, and sample metadata; the Skill runs the QIIME2 backend and delivers ASV, taxonomy, and diversity tables plus an HTML dashboard.

Quick Start

Ask the assistant to inspect your amplicon FASTQ sample sheet, confirm primer sequences and taxonomy database, and run the amplicon microbiome preflight and backend analysis.

Frequently Asked Questions about ngs-amplicon-microbiome

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

FAQPage Schema
How do I run a 16S amplicon analysis with QIIME2 or DADA2?

Provide a sample sheet, forward and reverse primer sequences, a taxonomy classifier such as a SILVA 138 QIIME2 artifact, and sample metadata, then invoke the backend runner with --backend qiime2 or --backend dada2. The runner validates inputs and writes ASV, taxonomy, and read-retention tables.

What is the difference between nf-core/ampliseq, QIIME2, and DADA2 for amplicon analysis?

nf-core/ampliseq is a reproducible end-to-end Nextflow pipeline suited for standardized runs. QIIME2 and DADA2 are used directly when you need notebook-level control or an existing lab protocol, with DADA2 running through Rscript for ASV inference.

Can I run amplicon analysis with only FASTQ files?

No. FASTQs alone support only a read-QC and readiness bundle with seqkit stats and FastQC reports. A full analysis requires primer sequences, primer orientation, a taxonomy database with version, and sample metadata.

Does the DADA2 backend require R to be installed?

Yes. The DADA2 backend checks for Rscript and the dada2 R package before execution. If they are missing, the run cannot proceed and you should use the QIIME2 or nf-core backend instead.

Why is beta diversity or PCoA blocked for my amplicon run?

Beta-diversity outputs are blocked when downstream tables are labeled synthetic or contain samples not present in the real sample sheet. You must pass --allow-synthetic-diversity explicitly to override this review-only safeguard.