vimalinx/bio-agent / .claude/skills/gen-random-reads
gen-random-reads
VerifiedUse when simulating transcriptome reads from a transcript FASTA and TPM table with `genRandomReads`, or when summarizing transcript lengths before building that TPM table.
gen-random-reads
Quick Start
- Command:
genRandomReads ... - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/genRandomReads - Two main modes:
--summarizeFastafor transcript lengths, or read generation with--transcriptFasta,--outputPrefix, and--expressionLevels
When To Use This Tool
- Simulate single-end or paired-end transcriptomic reads from a transcript FASTA.
- Build synthetic RNA-seq datasets from transcript-level TPM values for benchmarking.
- Summarize transcript names and lengths before constructing the TPM table.
- Encode ground-truth origins in read names when testing alignment or quantification pipelines.
Common Patterns
# 1) Summarize transcript IDs and lengths from a FASTA file
genRandomReads \
--summarizeFasta \
--transcriptFasta transcripts.fa \
--outputPrefix tx_summary
# 2) Generate single-end reads from a TPM table
genRandomReads \
--transcriptFasta transcripts.fa \
--outputPrefix sim_reads \
--expressionLevels tpm.tsv \
--totalReads 500000
# 3) Generate paired-end reads and preserve truth in read names
genRandomReads \
--transcriptFasta transcripts.fa \
--outputPrefix sim_pe \
--expressionLevels tpm.tsv \
--totalReads 200000 \
--pairedEnd \
--truthInReadNames
Recommended Workflow
- Run
--summarizeFastafirst so you know the available transcript IDs and lengths. - Build the required two-column tab-delimited expression file:
TranscriptID<TAB>TPM. - Decide on read length, total reads, and whether you need paired-end simulation or truth labels in the read names.
- Generate the dataset, then inspect the created files before feeding them into downstream aligners or quantifiers.
Guardrails
- For read generation,
--transcriptFasta,--outputPrefix, and--expressionLevelsare required; omitting--totalReadstriggers a warning and defaults to one million reads. --helpis not a clean help path: it is reported as an unrecognized option before the usage block is printed.- The expression file must be tab-delimited with transcript ID in column 1 and TPM in column 2.
--qualityRefFileexpects Phred+33 strings whose lengths match--readLen.--simpleTranscriptIdtruncates transcript names at the first|or space, which can change identifier matching if used carelessly.- The transcript FASTA can be plain or gzipped (
FASTA/gzin the usage text).
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 |