Skip to content

vimalinx/bio-agent / .claude/skills/vcftools

vcftools

Unverified

Use when working with Variant Call Format (VCF) files and need to filter, summarize, or manipulate variant data.

vcftools

Quick Start

  • Command: vcftools
  • Local executable: /home/vimalinx/miniforge3/envs/bio/bin/vcftools
  • Version: 0.1.17
  • Full reference: See references/help.md and the installed man page under /home/vimalinx/miniforge3/envs/bio/share/man/man1/vcftools.1

When To Use This Tool

  • Filter VCF or BCF files by site, variant type, allele frequency, or missingness.
  • Export summary statistics such as allele frequency, Hardy-Weinberg tests, or site depth.
  • Recode filtered VCFs for downstream tools.
  • Prefer vcftools for classic population-genetics style filtering and quick summaries.

Common Patterns

# 1) SNP-only filtered VCF
vcftools \
  --gzvcf cohort.vcf.gz \
  --remove-indels \
  --recode --recode-INFO-all \
  --out cohort.snps_only
# 2) Common-variant, low-missingness filter
vcftools \
  --gzvcf cohort.vcf.gz \
  --maf 0.05 \
  --max-missing 0.9 \
  --recode --recode-INFO-all \
  --out cohort.filtered
# 3) Allele-frequency report for one chromosome
vcftools \
  --gzvcf cohort.vcf.gz \
  --freq \
  --chr 1 \
  --out chr1.freq
# 4) Site mean depth summary
vcftools \
  --gzvcf cohort.vcf.gz \
  --site-mean-depth \
  --out cohort.depth

Recommended Workflow

  1. Pick the correct input mode first: --vcf, --gzvcf, or --bcf.
  2. Separate filtering passes from statistics passes so outputs stay interpretable.
  3. When writing a new VCF, use --recode and usually --recode-INFO-all.
  4. Keep the filtering thresholds documented, because small MAF or missingness changes can materially alter results.

Guardrails

  • If --out is omitted, files default to the out.* prefix in the current directory.
  • --recode writes a new VCF; without it many filtering commands only emit summary files.
  • --max-missing 1.0 keeps only sites with no missing genotypes, which is often much harsher than intended.
  • Distinguish site filters from genotype-aware downstream interpretation; filtering can strongly bias frequency-based summaries.
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 114kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 114kUpdated Claude CodeCodexVerifiedInstall