ngs-dna-umi-panel-variants

Plans and runs UMI-aware targeted DNA panel variant calling workflows with consensus QC.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Targeted DNA panels that use UMIs, duplex consensus reads, and molecular barcodes require specialized handling to detect low-frequency variants reliably, and ordinary germline pipelines mishandle barcode-aware depth and artifact review.

Core Features & Use Cases

  • UMI-Aware Workflow Planning: Confirms UMI layout (inline, index, single, duplex), consensus state, and panel targets before any trimming or alignment decisions.
  • Auditable Pipeline Execution: Runs preflight checks and a dedicated runner producing consensus/variant command plans, target coverage QC, and low-frequency calling settings via fgbio, samtools, and bcftools.
  • Molecular Evidence QC: Emits post-run summaries and molecular evidence contracts tracking family size, duplex fraction, hotspot review, and low-AF evidence readiness per sample.
  • Use Case: A lab analyst receives FASTQs from a duplex UMI panel targeting cancer hotspots and needs an auditable plan that separates raw depth from unique molecular depth before calling variants below 1% allele fraction.

Quick Start

Ask the assistant to plan a UMI-aware targeted DNA panel workflow by providing the panel target BED, UMI layout, reference build, and sample sheet so it can run the preflight check and generate the consensus and variant calling plan.

Frequently Asked Questions about ngs-dna-umi-panel-variants

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

FAQPage Schema
How do I call low-frequency variants from a UMI panel?

Run the dedicated UMI panel runner with a sample sheet, reference FASTA, target BED, and UMI mode such as duplex. It generates consensus reads, target coverage QC, and variant calls with allele fraction, depth, and strand or duplex support annotations.

What is duplex consensus sequencing in targeted panels?

Duplex consensus sequencing combines reads from both strands of the same original DNA molecule using paired UMIs, sharply reducing sequencing and PCR errors. This enables confident detection of variants at very low allele fractions in targeted panels.

Can I use this workflow for ordinary germline variant calling?

No, this workflow is designed for panels where molecular barcodes, UMIs, or duplex consensus are central. For ordinary germline calling without molecular consensus, use the ngs-dna-germline-variants skill instead.

What tools are required to run UMI consensus variant calling locally?

The local backend uses fgbio for UMI consensus generation, samtools for alignment processing, and bcftools for variant calling and stats. The preflight script emits an install plan, and missing resources are reported in the readiness outputs.

Why should UMI bases not be trimmed before analysis?

Trimming UMI bases before their layout and destination are known destroys the molecular barcode information needed for consensus generation. The workflow requires confirming whether UMIs are inline, in index reads, single, or duplex before any read processing.

What QC metrics matter for low allele fraction variant calls?

Key metrics include unique molecular depth versus raw depth, family size distribution, duplex fraction, on-target rate, coverage uniformity, and per-target dropout. The post-run summary and molecular evidence contract track these per sample for low-AF review.