bio-genome-intervals-interval-arithmetic
Core set operations on genomic intervals using bedtools (CLI) and pybedtools (Python).
Install / Use
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-genome-intervals-interval-arithmeticInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Healthcare & Life SciencesSupported Platforms
Our assessment of bio-genome-intervals-interval-arithmetic
bio-genome-intervals-interval-arithmetic scores 86/100 on our quality scale, 34th of 47 Healthcare & Life Sciences skills we index.
Its SKILL.md is 12 KB long, well organised into 120 sections with 25 code examples: a thorough specification that gives an agent plenty to work with.
With 3,034 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-03 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 86/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
bio-genome-intervals-interval-arithmetic compared with similar skills
All 4 of these similar skills score higher than bio-genome-intervals-interval-arithmetic; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bio-genome-intervals-interval-arithmetic (this skill)by FreedomIntelligence | 86 | 3.0k | 4mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install bio-genome-intervals-interval-arithmetic?
- Run
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-genome-intervals-interval-arithmetic. The install tabs above show the steps for each supported agent. - Which AI agents does bio-genome-intervals-interval-arithmetic work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is bio-genome-intervals-interval-arithmetic safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 86/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is bio-genome-intervals-interval-arithmetic still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: bio-genome-intervals-interval-arithmetic description: Core interval arithmetic operations including intersect, subtract, merge, complement, map, and groupby using bedtools and pybedtools. Use when finding overlapping regions, removing overlaps, combining adjacent intervals, or transferring annotations between interval files. tool_type: mixed primary_tool: bedtools measurable_outcome: Execute skill workflow successfully with valid output within 15 minutes. allowed-tools:
- read_file
- run_shell_command
Interval Arithmetic
Core set operations on genomic intervals using bedtools (CLI) and pybedtools (Python).
Intersect - Find Overlapping Regions
CLI
# Find overlapping intervals (report A entries that overlap B)
bedtools intersect -a peaks.bed -b genes.bed > overlapping.bed
# Report original A intervals (default behavior)
bedtools intersect -a peaks.bed -b genes.bed > peaks_in_genes.bed
# Report overlapping portion only
bedtools intersect -a peaks.bed -b genes.bed > overlap_regions.bed
# Report both A and B fields
bedtools intersect -a peaks.bed -b genes.bed -wa -wb > with_gene_info.bed
# Write original A entries that overlap B (-u for unique)
bedtools intersect -a peaks.bed -b genes.bed -u > peaks_overlapping_genes.bed
# Report A entries that do NOT overlap B
bedtools intersect -a peaks.bed -b genes.bed -v > peaks_not_in_genes.bed
# Require minimum overlap fraction (50% of A must overlap)
bedtools intersect -a peaks.bed -b genes.bed -f 0.5 > min_50pct.bed
# Reciprocal overlap (both A and B must have 50% overlap)
bedtools intersect -a peaks.bed -b genes.bed -f 0.5 -r > reciprocal_50pct.bed
# Count overlaps
bedtools intersect -a peaks.bed -b genes.bed -c > with_counts.bed
# Multiple B files
bedtools intersect -a peaks.bed -b genes.bed promoters.bed enhancers.bed -names genes promoters enhancers > multi.bed
Python
import pybedtools
a = pybedtools.BedTool('peaks.bed')
b = pybedtools.BedTool('genes.bed')
# Basic intersection
result = a.intersect(b)
# Keep original A entries that overlap
result = a.intersect(b, u=True)
# Report both A and B
result = a.intersect(b, wa=True, wb=True)
# Non-overlapping (inverse)
result = a.intersect(b, v=True)
# Minimum overlap fraction
result = a.intersect(b, f=0.5)
# Reciprocal overlap
result = a.intersect(b, f=0.5, r=True)
# Count overlaps
result = a.intersect(b, c=True)
# Save result
result.saveas('output.bed')
Subtract - Remove Overlapping Regions
CLI
# Remove portions of A that overlap B
bedtools subtract -a regions.bed -b exclude.bed > remaining.bed
# Remove entire A interval if ANY overlap with B
bedtools subtract -a regions.bed -b exclude.bed -A > non_overlapping.bed
# Require minimum overlap before removal
bedtools subtract -a regions.bed -b exclude.bed -f 0.5 > subtract_50pct.bed
Python
import pybedtools
a = pybedtools.BedTool('regions.bed')
b = pybedtools.BedTool('exclude.bed')
# Basic subtraction (remove overlapping portions)
result = a.subtract(b)
# Remove entire interval if any overlap
result = a.subtract(b, A=True)
# Require minimum overlap
result = a.subtract(b, f=0.5)
result.saveas('remaining.bed')
Merge - Combine Overlapping/Adjacent Intervals
CLI
# Merge overlapping intervals (input must be sorted)
bedtools sort -i peaks.bed | bedtools merge > merged.bed
# Merge intervals within N bp of each other
bedtools sort -i peaks.bed | bedtools merge -d 100 > merged_100bp.bed
# Report number of merged intervals
bedtools sort -i peaks.bed | bedtools merge -c 1 -o count > merged_counts.bed
# Aggregate columns (e.g., concatenate names, sum scores)
bedtools sort -i peaks.bed | bedtools merge -c 4,5 -o collapse,sum > merged_agg.bed
# Keep max score
bedtools sort -i peaks.bed | bedtools merge -c 5 -o max > merged_max.bed
# Strand-specific merge
bedtools sort -i peaks.bed | bedtools merge -s > merged_stranded.bed
Python
import pybedtools
bed = pybedtools.BedTool('peaks.bed')
# Basic merge (auto-sorts)
merged = bed.sort().merge()
# Merge within distance
merged = bed.sort().merge(d=100)
# Count merged intervals
merged = bed.sort().merge(c=1, o='count')
# Aggregate columns (collapse names, sum scores)
merged = bed.sort().merge(c='4,5', o='collapse,sum')
# Strand-specific
merged = bed.sort().merge(s=True)
merged.saveas('merged.bed')
Complement - Get Uncovered Regions
CLI
# Get regions NOT covered by intervals (requires genome file)
bedtools complement -i covered.bed -g genome.txt > uncovered.bed
# genome.txt format: chr<TAB>size
# chr1 248956422
# chr2 242193529
# ...
Python
import pybedtools
bed = pybedtools.BedTool('covered.bed')
genome = 'genome.txt' # or dict: {'chr1': (0, 248956422), ...}
# Get complement
uncovered = bed.complement(g=genome)
uncovered.saveas('uncovered.bed')
# Using genome dict
genome_dict = pybedtools.chromsizes('hg38') # Built-in genome sizes
uncovered = bed.complement(genome=genome_dict)
Cluster - Group Overlapping Intervals
CLI
# Assign cluster IDs to overlapping intervals
bedtools sort -i peaks.bed | bedtools cluster > clustered.bed
# Cluster within distance
bedtools sort -i peaks.bed | bedtools cluster -d 100 > clustered_100bp.bed
Python
import pybedtools
bed = pybedtools.BedTool('peaks.bed')
clustered = bed.sort().cluster()
clustered.saveas('clustered.bed')
Multiinter - Find Multi-way Overlaps
CLI
# Find regions covered by multiple files
bedtools multiinter -i sample1.bed sample2.bed sample3.bed > multi_overlap.bed
# With sample names
bedtools multiinter -i sample1.bed sample2.bed sample3.bed \
-names s1 s2 s3 > multi_overlap.bed
# Header output
bedtools multiinter -i sample1.bed sample2.bed sample3.bed -header > multi_overlap.bed
Python
import pybedtools
beds = [pybedtools.BedTool(f) for f in ['s1.bed', 's2.bed', 's3.bed']]
# Note: multiinter requires CLI workaround
result = pybedtools.BedTool().multi_intersect(i=[b.fn for b in beds])
Jaccard - Similarity Metric
CLI
# Calculate Jaccard similarity between two BED files
bedtools jaccard -a sample1.bed -b sample2.bed
# Output: intersection, union, jaccard, n_intersections
Python
import pybedtools
a = pybedtools.BedTool('sample1.bed')
b = pybedtools.BedTool('sample2.bed')
result = a.jaccard(b)
print(f"Jaccard index: {result['jaccard']}")
print(f"Intersection: {result['intersection']} bp")
print(f"Union: {result['union']} bp")
Fisher's Exact Test
CLI
# Statistical test for overlap significance
bedtools fisher -a peaks.bed -b genes.bed -g genome.txt
Python
import pybedtools
a = pybedtools.BedTool('peaks.bed')
b = pybedtools.BedTool('genes.bed')
result = a.fisher(b, genome='genome.txt')
print(result) # Contains p-values and odds ratio
Shuffle - Random Permutation
CLI
# Randomly shuffle intervals (for null hypothesis testing)
bedtools shuffle -i peaks.bed -g genome.txt > shuffled.bed
# Exclude certain regions
bedtools shuffle -i peaks.bed -g genome.txt -excl blacklist.bed > shuffled.bed
# Maintain chromosome distribution
bedtools shuffle -i peaks.bed -g genome.txt -chrom > shuffled.bed
Python
import pybedtools
bed = pybedtools.BedTool('peaks.bed')
shuffled = bed.shuffle(g='genome.txt')
shuffled.saveas('shuffled.bed')
Map - Transfer Values Between Files
Map overlapping B values onto A intervals with aggregation.
CLI
# Map mean scores from B to A
bedtools map -a genes.bed -b scores.bedGraph -c 4 -o mean > genes_with_scores.bed
# Multiple operations at once
bedtools map -a regions.bed -b data.bed -c 5,5,5 -o mean,min,max > multi_stats.bed
# Count overlapping features
bedtools map -a genes.bed -b peaks.bed -c 1 -o count > genes_with_peak_counts.bed
# Collapse names of overlapping features
bedtools map -a genes.bed -b peaks.bed -c 4 -o collapse > genes_with_peak_names.bed
# Distinct values only
bedtools map -a genes.bed -b annotations.bed -c 4 -o distinct > unique_annotations.bed
Python
import pybedtools
a = pybedtools.BedTool('genes.bed')
b = pybedtools.BedTool('scores.bedGraph')
# Map mean scores
result = a.map(b, c=4, o='mean')
# Multiple operations
result = a.map(b, c='5,5,5', o='mean,min,max')
result.saveas('mapped.bed')
Map Operations
| Operation | Description | |-----------|-------------| | sum | Sum of values | | count | Number of overlapping features | | count_distinct | Number of distinct values | | min, max | Minimum/maximum value | | mean, median | Average values | | collapse | Comma-separated list | | distinct | Unique values only | | first, last | First/last overlapping value |
Groupby - Aggregate by Columns
Group intervals and compute summary statistics.
CLI
# Sum scores by gene (column 4)
bedtools groupby -i sorted.bed -g 4 -c 5 -o sum > gene_totals.bed
# Group by chromosome and compute stats
bedtools groupby -i sorted.bed -g 1 -c 2,3 -o min,max > chr_ranges.bed
# Multiple grouping columns
bedtools groupby -i sorted.bed -g 1,4 -c 5 -o mean > by_chr_gene.bed
# Collapse names within groups
bedtools groupby -i sorted.bed -g 1,2,3 -c 4 -o collapse > merged_names.bed
# Count features per group
bedtools groupby -i sorted.bed -g 1 -c 1 -o count > features_per_chr.bed
# Use column ranges
bedtools groupby -i sorted.bed -g 1-3 -c 5 -o sum > grouped.bed
Python
import pybedtools
bed = pybedtools.BedTool('sorted.bed')
# Group by column 4, sum column 5
result = bed.groupby(g=4, c=5, o='sum')
# Multiple operations
result = bed.groupby(g=[1, 4], c=[5, 5], o=['mean', 'count'])
result.saveas('grouped.bed')
Note: Input must be sorted by grouping columns.
Common Patterns
Find Peaks in Promoters
import pybedtools
peaks = pybedtools.BedTool('peaks.bed')
promoters = pybedtools.BedTool('promoters.bed')
# Peaks overlapping promoters
peaks_in_promoters = peaks.intersect(promoters, u=True)
print(f'{peaks_in_promoters.count()} peaks in promoters')
Find Unique Regions in Sample
import pybedtools
sample_a = pybedtools.BedTool('sample_a.bed')
sample_b = pybedtools.BedTool('sample_b.bed')
# Regions unique to sample A
unique_a = sample_a.intersect(sample_b, v=True)
unique_a.saveas('unique_to_a.bed')
Merge Replicates
# Concatenate and merge peaks from replicates
cat rep1.bed rep2.bed rep3.bed | bedtools sort | bedtools merge -d 100 > consensus.bed
Key Parameters
| Operation | Key Flags | Description | |-----------|-----------|-------------| | intersect -u | Unique | Report A once if overlap | | intersect -v | Inverse | A that don't overlap B | | intersect -f | Fraction | Minimum overlap fraction | | intersect -r | Reciprocal | Both must meet -f threshold | | intersect -c | Count | Count overlapping B features | | subtract -A | All | Remove entire A if any overlap | | merge -d | Distance | Merge within N bp | | merge -c -o | Columns/Ops | Aggregate columns |
Related Skills
- bed-file-basics - BED format and creation
- proximity-operations - closest, window, flank, slop
- coverage-analysis - coverage calculations
- chip-seq/peak-calling - peak file operations
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
