AGENT SKILL

ngs-dna-umi-panel-variants

Run or plan targeted DNA panel variant workflows that use UMIs, duplex consensus reads, molecular barcodes, low-frequency calling, target coverage, and panel-specific QC.

License 许可
MIT
最近更新
2026-07-19
Stars
★ 1
Forks
1

01 前言 Front Matter

name
ngs-dna-umi-panel-variants
description
Run or plan targeted DNA panel variant workflows that use UMIs, duplex consensus reads, molecular barcodes, low-frequency calling, target coverage, and panel-specific QC.

02 资源文件 1

03 SKILL.md 正文

UMI Panel DNA Variants

Use this skill for targeted DNA panels where molecular barcodes, UMIs, duplex consensus, or low-frequency allele detection are central to the analysis. If the panel is ordinary germline calling without molecular consensus, use ngs-dna-germline-variants.

Essential Inputs

Confirm:

  • panel/capture kit name and target BED
  • UMI layout: inline read, index read, single UMI, duplex UMI, or unknown
  • whether consensus reads have already been generated
  • FASTQ/BAM input and pairing convention
  • reference build and panel-specific annotation requirements
  • minimum allele fraction goal and intended use: screening, research, validation, or exploratory
  • positive/negative controls and expected spike-ins when available

Route

Use a lab-validated panel workflow when provided. For public-tool planning, combine FASTQ QC, UMI extraction/consensus generation, alignment, target coverage QC, and variant calling as separate audited stages.

Preflight command:

python plugins/ngs-analysis/scripts/ngs_preflight.py --pipeline dna_umi_panel_variants --emit-install-plan

For compact local checks from prepared consensus or alignment BAM/CRAM files, use the dedicated UMI panel runner:

python plugins/ngs-analysis/scripts/run_dna_umi_panel_variants.py \
  --sample-sheet umi_panel_samples.tsv \
  --reference-fasta reference.fa \
  --target-bed panel_targets.bed \
  --umi-mode duplex \
  --umi-tag RX \
  --execute

This writes the consensus/variant command plan, molecular-consensus state, low-frequency calling settings, visualization index, qc/umi_postrun_summary.{tsv,json}, qc/umi_molecular_evidence_contract.{tsv,json}, and consensus-BAM VCF outputs when the local fgbio/samtools/bcftools backend is available. The post-run summary parses consensus flagstat, target coverage, bcftools stats, and family-size/duplex files when present; missing metrics stay explicit in the notes column. The molecular evidence contract keeps the low-AF review requirements visible per sample: consensus BAM, family-size or molecule-support metrics, variant stats, hotspot review, and duplex review.

The direct runner also emits resources/resource_plan.json, resource_manifest.tsv, resource_env.sh, and resource_readiness.md. The resource check is advisory by default so custom or reduced references can still be planned; add --genome-build, --bundle-root <bundle>=<path>, and --require-resource-plan when missing registered reference bundles should block readiness.

Decision Points

  • Do not trim or discard UMI bases until their layout and destination are known.
  • Separate raw read depth from unique molecular depth and consensus depth.
  • Track on-target rate, coverage uniformity, family size distribution, strand/duplex support, and per-target dropout.
  • Low allele fraction calls require stronger artifact review than ordinary germline calls.
  • Use panel-specific hotspot/blacklist rules only when their provenance is known.

Outputs

Produce:

  • UMI layout and consensus strategy
  • target BED/resource manifest
  • raw-depth, molecular-depth, and consensus-depth QC summary
  • qc/umi_postrun_summary.tsv for consensus reads, target coverage, variant counts, family size, and duplex fraction
  • qc/umi_molecular_evidence_contract.tsv for low-AF evidence readiness, hotspot review, and duplex review expectations
  • variant calls with allele fraction, depth, strand/duplex support, and filtering rationale
  • limitations around sensitivity, panel dropout, molecule count, and non-validated interpretation

04 同仓库更多 Skills

zfifteen
zfifteen/skills-catalog

Zotero

Use Zotero Desktop from Codex to enable/probe the local API, search a local Zotero library, list items/collections/tags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX/RIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.

★ 1
zfifteen
zfifteen/skills-catalog

zoom-apps-sdk

Use when using Apps SDK.

★ 1
zfifteen
zfifteen/skills-catalog

youtube

Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript. Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or "what does this video actually say". The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content. Triggers: "youtube transcript", "get the transcript of this video", "summarize this youtube video", "what did they say in https://youtube.com/...", "key claims from this talk".

★ 1
zfifteen
zfifteen/skills-catalog

yeet

Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.

★ 1
zfifteen
zfifteen/skills-catalog

x-post-creator

Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, /x-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs/x-posts/[story-name]/.

★ 1
zfifteen
zfifteen/skills-catalog

x-api

Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X/x.com, reading threads and replies, creating lists, staging/publishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions /x-api or "search X".

★ 1