vimalinx/bio-agent / .claude/skills/fasta-sanitize-pl
fasta-sanitize-pl
VerifiedUse when sanitizing FASTA or FASTQ record names so they conform to SAM-compatible reference / read-name character rules.
fasta-sanitize-pl
Quick Start
- Command:
zcat input.fa.gz | /home/vimalinx/miniforge3/envs/bio/bin/fasta-sanitize.pl > output.fa - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/fasta-sanitize.pl - Reference: references/help.md
When To Use This Tool
- Rewrite invalid FASTA / FASTQ record names before alignment or downstream SAM / VCF generation.
- Keep reference names consistent with SAM naming constraints early in the workflow.
- Sanitize both FASTA and FASTQ headers with one streaming pass.
Common Patterns
# 1) Sanitize a FASTA stream before indexing or alignment
zcat input.fa.gz | \
/home/vimalinx/miniforge3/envs/bio/bin/fasta-sanitize.pl \
> clean.fa
# 2) Sanitize FASTQ headers in a streaming pipeline
zcat reads.fq.gz | \
/home/vimalinx/miniforge3/envs/bio/bin/fasta-sanitize.pl \
> clean.fq
Recommended Workflow
- Run it before alignment or any step that depends on consistent SAM-compatible names.
- Capture stdout to a new FASTA / FASTQ file.
- Watch stderr for
Renaming reference ...messages. - Rebuild any downstream indices from the sanitized file rather than mixing old names with new ones.
Guardrails
- The tool does not support
--helpor--versionflags; it expects file arguments. - It autodetects FASTQ by
@headers and handles quality blocks, not just FASTA. - Only the first whitespace-delimited token in the header is sanitized as the record name; trailing descriptive text is preserved.
- Valid names pass through unchanged, so not every file will emit rename messages on stderr.
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: 193k | 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: 193k | 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: 193k | Updated | Claude CodeCodex | Verified | Install |