ngs-fastq-qc

Validates FASTQ inputs and runs FastQC, MultiQC, fastp, and Cutadapt QC workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Raw sequencing reads often contain adapter contamination, quality drops, pairing errors, or artifacts that silently corrupt downstream analysis. This Skill validates FASTQ inputs, runs standardized QC with FastQC and MultiQC, interprets the results, and only recommends trimming with fastp or Cutadapt when the evidence warrants it.

Core Features & Use Cases

  • Automated QC Execution: Runs a plugin-owned local runner that performs pre-execution validation, then produces FastQC/MultiQC reports, a run manifest, and a structured qc_interpretation.json.
  • Guided Trimming Decisions: Interprets per-base quality, adapter signal, poly-G artifacts, duplication, and pairing issues before choosing fastp or Cutadapt trimming branches, never overwriting raw reads.
  • Use Case: A researcher receives demultiplexed paired-end reads from a sequencing facility and needs to know whether the libraries are usable for variant calling. The Skill inventories the read pairs, runs QC, flags per-tile failures and adapter content, and recommends a Cutadapt trim with explicit adapter sequences.

Quick Start

Ask the assistant to inspect your FASTQ files, infer R1/R2 pairings, run FastQC and MultiQC QC, and recommend whether trimming is needed.

Frequently Asked Questions about ngs-fastq-qc

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

FAQPage Schema
How do I run FastQC and MultiQC on paired-end FASTQ files?

Run FastQC on all FASTQ files with multithreading, then aggregate results with MultiQC into a single project report. This Skill automates both steps through its local runner, which also validates sample sheets and read pairing before execution.

fastp vs Cutadapt for adapter trimming, which should I use?

Use Cutadapt when explicit adapter or primer sequences must be specified, and fastp when automatic all-in-one QC and trimming is acceptable. The Skill inspects QC signals first and recommends the appropriate branch rather than trimming by default.

Does FASTQ QC trimming overwrite my raw sequencing reads?

No. The workflow never overwrites input FASTQs and preserves raw QC reports even when trimmed FASTQs are produced. Outputs go to a timestamped run directory containing manifests, logs, and reports.

Why does my FASTQ show high duplication or overrepresented sequences?

High duplication can be expected for amplicons, targeted panels, or low-input libraries, while overrepresented sequences may be adapters, primers, rRNA, PhiX, or true biology. The Skill classifies these signals before recommending any filtering.

When should I not trim FASTQ reads before alignment?

Avoid trimming when QC looks normal or when downstream analysis requires original read lengths, UMIs, or inline barcodes. The Skill inspects raw QC first and recommends a no-trimming path with rationale when warranted.