vimalinx/bio-agent / .claude/skills/vcf-convert
vcf-convert
UnverifiedUse when converting VCF files between format versions (4.0, 4.1, 4.2) for compatibility with downstream bioinformatics tools.
vcf-convert
Quick Start
- Command:
vcf-convert -v <4.0|4.1|4.2> [options] < in.vcf > out.vcf - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/vcf-convert - Fallback launcher in this workspace:
/home/vimalinx/miniforge3/envs/bio/bin/perl /home/vimalinx/miniforge3/envs/bio/bin/vcf-convert - Full reference: See
references/help.md
When To Use This Tool
- Convert a VCF stream between versions 4.0, 4.1, and 4.2 for downstream compatibility.
- Upgrade older VCFs before handing them to newer tooling.
- Normalize indel representation during version conversion when you can provide the reference FASTA.
- Keep using it only if you already depend on the vcftools Perl helpers; for fresh pipelines, prefer modern
bcftools-based normalization when possible.
Common Patterns
# 1) Upgrade an older SNP-only VCF to 4.2
/home/vimalinx/miniforge3/envs/bio/bin/perl \
/home/vimalinx/miniforge3/envs/bio/bin/vcf-convert \
-v 4.2 \
< input.vcf > output.vcf
# 2) Convert an indel-containing VCF with a faidx-indexed reference
/home/vimalinx/miniforge3/envs/bio/bin/perl \
/home/vimalinx/miniforge3/envs/bio/bin/vcf-convert \
-v 4.2 \
-r ref.fa \
< input.vcf > output.vcf
# 3) Downgrade cautiously for an older consumer
/home/vimalinx/miniforge3/envs/bio/bin/perl \
/home/vimalinx/miniforge3/envs/bio/bin/vcf-convert \
-v 4.1 \
< input.vcf > output.vcf
Recommended Workflow
- Confirm which VCF version the downstream tool actually requires before converting anything.
- Treat the input as a stream: feed it on stdin and capture the converted VCF from stdout.
- Provide
-r ref.fawhenever non-SNP variants are present so indel REF / ALT rewriting is well-defined. - Validate the output with a downstream parser or
vcf-validatorbefore swapping it into a pipeline.
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
-v/--versionoption sets the target VCF format version; it is not a program-version flag. - Downgrading VCF versions is explicitly marked upstream as experimental.
- Indel conversion needs a samtools-faidx indexed reference FASTA via
-r. - This tool reads from stdin and writes to stdout; it does not edit files in place.
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 |