vimalinx/bio-agent / .claude/skills/shuffle-bed
shuffle-bed
VerifiedUse when you need to randomly permute feature locations across a genome for statistical testing or generating null distributions.
shuffle-bed
Quick Start
- Command:
shuffleBed -i intervals.bed -g genome.txt [options] - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/shuffleBed - Full reference: See
references/help.md
When To Use This Tool
- Randomize interval locations to build null models for enrichment or overlap testing.
- Preserve original interval lengths while relocating them within a genome.
- Restrict random placement with inclusion or exclusion masks.
- Keep intervals on the same chromosome or enforce non-overlap among shuffled results.
Common Patterns
# 1) Basic genome-wide shuffle
shuffleBed \
-i peaks.bed \
-g genome.txt > peaks.shuffled.bed
# 2) Reproducible same-chromosome shuffle excluding blacklist regions
shuffleBed \
-i peaks.bed \
-g genome.txt \
-chrom \
-excl blacklist.bed \
-seed 42 > peaks.shuffled.bed
# 3) Shuffle only within allowed regions
shuffleBed \
-i peaks.bed \
-g genome.txt \
-incl accessible_regions.bed \
-maxTries 10000
Recommended Workflow
- Decide whether the null model should preserve chromosome identity (
-chrom) or allow genome-wide relocation. - Add
-seedwhenever the shuffled set must be reproducible. - Use
-incl,-excl,-noOverlapping, and-maxTriesto match the biological constraints of the null model. - Check that the shuffled output preserved record count and interval length distribution before using it for inference.
Guardrails
-iand-gare required.-incldisables-chromFirst.-fcan be used with-exclbut not with-incl.-chromforces same-chromosome placement and also forces-chromFirst.-allowBeyondChromEndchanges the interval-length preservation rule near chromosome ends, so only use it intentionally.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |