vimalinx/bio-agent / .claude/skills/vcf-phased-join
vcf-phased-join
VerifiedUse when joining multiple overlapping pre-phased VCF chunks into a single phased VCF using heterozygous calls from overlaps to determine correct phase.
vcf-phased-join
Quick Start
- Command:
vcf-phased-join -o merged.vcf chunk1.vcf chunk2.vcf ... - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/vcf-phased-join - Fallback launcher in this workspace:
/home/vimalinx/miniforge3/envs/bio/bin/perl /home/vimalinx/miniforge3/envs/bio/bin/vcf-phased-join - Full reference: See
references/help.md
When To Use This Tool
- Merge overlapping pre-phased VCF chunks into one phased VCF.
- Use overlap heterozygous calls to decide whether phase blocks need swapping across chunk boundaries.
- Break blocks when
PQfalls below a threshold with-q. - Provide a file list with
-lwhen the chunk set is large or generated programmatically.
Common Patterns
# 1) Join three overlapping phased chunks
/home/vimalinx/miniforge3/envs/bio/bin/perl \
/home/vimalinx/miniforge3/envs/bio/bin/vcf-phased-join \
-o merged.vcf \
chr1.part1.vcf chr1.part2.vcf chr1.part3.vcf
# 2) Join from a manifest file
/home/vimalinx/miniforge3/envs/bio/bin/perl \
/home/vimalinx/miniforge3/envs/bio/bin/vcf-phased-join \
-l chunks.txt \
-o merged.vcf
# 3) Tighten the join criteria
/home/vimalinx/miniforge3/envs/bio/bin/perl \
/home/vimalinx/miniforge3/envs/bio/bin/vcf-phased-join \
-j 20 \
-q 0.9 \
-o merged.vcf \
chr1.part1.vcf chr1.part2.vcf
Recommended Workflow
- Confirm that all chunks are position-sorted, overlapping, and represent the same samples in the same column set.
- Start with the default
-j 10and-q 0.6thresholds unless you have a benchmarked reason to tighten them. - Write to a real output file with
-oso you also capture the sidecar phase log (.plog). - Inspect the merged VCF and
.plog, then validate sample ordering and phase continuity before downstream use.
Guardrails
- In this shell, direct invocation may fail with
Can't locate Vcf.pm; activate the bio environment first or call the script through/home/vimalinx/miniforge3/envs/bio/bin/perl. - The inputs must already be phased and overlapping; this tool does not infer phase from unphased calls.
- The script warns when column names differ across files; use
vcf-shuffle-colsfirst if sample order is inconsistent. - Output
-o merged.vcfalso createsmerged.plogwith phase-join diagnostics. - There are hidden
--split-*modes in the script source, but the stable documented interface is the join workflow above.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |