AGENT SKILL

ngs-analysis-router

Route BCL, FASTQ, BAM/CRAM, count-matrix, or VCF sequencing requests to the right public NGS analysis skill and ask only the missing assay-specific setup questions.

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

01 前言 Front Matter

name
ngs-analysis-router
description
Route BCL, FASTQ, BAM/CRAM, count-matrix, or VCF sequencing requests to the right public NGS analysis skill and ask only the missing assay-specific setup questions.

02 资源文件 1

03 SKILL.md 正文

Life Sciences NGS Analysis Router

Use this skill as the top-level entrypoint for ambiguous or broad sequencing-analysis requests.

Start Here

Inspect the available inputs before asking the user questions. Look for:

  • Illumina run-folder files: RunInfo.xml, RunParameters.xml, SampleSheet.csv, Data/Intensities/BaseCalls
  • FASTQs: *.fastq, *.fq, *.fastq.gz, *.fq.gz
  • BAM/CRAM/VCF: *.bam, *.cram, *.vcf, *.vcf.gz
  • count matrices: matrix.mtx, features.tsv, barcodes.tsv, *.h5, *.h5ad, *.rds
  • metadata: sample sheets, design files, target BEDs, reference FASTA/GTF, primer files

Read references/intake-schema.json and references/pipeline-registry.json when forming the route.

Intake Rules

Ask the smallest set of missing questions needed to choose a defensible pipeline. Do not ask the full questionnaire if file inspection already answers a field.

Always resolve:

  • input type
  • assay type
  • desired output
  • organism/reference
  • paired-end vs single-end when FASTQs are involved
  • any assay-specific design file or metadata required for the requested result
  • runtime constraints: local/HPC/cloud, container availability, and whether installs are allowed

For human data, ask whether cloud upload is allowed before suggesting BaseSpace, Terra, DNAnexus, or any cloud path.

Routing

Route to one leaf skill:

  • BCL run folder or demultiplexing: ngs-bcl-to-fastq
  • QC/trimming only: ngs-fastq-qc
  • WGS/WES/panel variants: ngs-dna-variant-calling, then a subtype skill when the analysis model is clear
  • germline WGS/WES/panel variants: ngs-dna-germline-variants
  • tumor-normal or tumor-only somatic variants: ngs-dna-somatic-variants
  • UMI, duplex, or low-frequency targeted panels: ngs-dna-umi-panel-variants
  • bulk RNA-seq kickoff: ngs-bulk-rnaseq
  • bulk RNA-seq FASTQ-to-count QC: ngs-bulk-rnaseq-counts-qc
  • bulk RNA-seq differential expression from counts: ngs-bulk-rnaseq-differential-expression
  • single-cell or single-nucleus FASTQ-to-matrix kickoff: ngs-scrna-seq
  • single-cell or single-nucleus post-count QC/annotation/UMAP: scrna-seq-qc
  • epigenomics kickoff: ngs-epigenomics-peaks
  • ATAC-seq QC/peaks/accessibility: ngs-atacseq-peaks-qc
  • ChIP-seq, CUT&RUN, or CUT&Tag QC/peaks: ngs-chip-cutrun-peaks-qc
  • 16S/18S/ITS/COI amplicons: ngs-amplicon-microbiome
  • shotgun metagenomics: ngs-shotgun-metagenomics
  • runtime/package setup only: ngs-runtime-env

Prefer public, runtime-installable packages and nf-core workflows. Surface license/EULA/account boundaries before using proprietary or cloud tools.

Preflight

Before proposing installation or execution, run a preflight plan from the repo root:

python plugins/ngs-analysis/scripts/ngs_preflight.py --pipeline <pipeline_key> --emit-install-plan

When the user needs an approval-ready install handoff, write persistent install artifacts:

python plugins/ngs-analysis/scripts/ngs_preflight.py --pipeline <pipeline_key> --manager micromamba --install-plan-outdir runtime_readiness/<pipeline_key>_install

Treat install_plan.json as the canonical review artifact. install_commands.sh is generated from the same plan and stays review-only unless the user explicitly approves execution with NGS_RUN_INSTALL_COMMANDS=1.

For reference- or database-heavy pipelines, also create a resource plan before saying the workflow is runnable:

python plugins/ngs-analysis/scripts/ngs_reference_manager.py plan --pipeline <pipeline_key> --genome-build <build> --outdir resource_readiness/<pipeline_key>

Use --include-optional for shotgun, amplicon, or motif-enabled epigenomics runs when optional databases materially affect the requested output.

Use --network-checks only when the user allows network checks. Use --install-missing --yes only when the user explicitly asks to install.

Output Contract

Return:

  1. the routed analysis type and confidence
  2. missing essential parameters, if any
  3. recommended public pipeline or package family
  4. local tool preflight summary
  5. preflight-first command or next concrete action
  6. caveats around licenses, cloud upload, database size, and reference data

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