bio-alignment-sorting
Sort alignment files by coordinate or read name using samtools and pysam.
Install / Use
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-alignment-sortingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Healthcare & Life SciencesSupported Platforms
Tags
Our assessment of bio-alignment-sorting
bio-alignment-sorting scores 86/100 on our quality scale, 24th of 47 Healthcare & Life Sciences skills we index.
Its SKILL.md is 7.0 KB long, well organised into 60 sections with 29 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-09-30. 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-alignment-sorting compared with similar skills
All 4 of these similar skills score higher than bio-alignment-sorting; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bio-alignment-sorting (this skill)by FreedomIntelligence | 86 | 3.0k | 4mo ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install bio-alignment-sorting?
- Run
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-alignment-sorting. The install tabs above show the steps for each supported agent. - Which AI agents does bio-alignment-sorting 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-alignment-sorting 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-alignment-sorting 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-alignment-sorting description: Sort alignment files by coordinate or read name using samtools and pysam. Use when preparing BAM files for indexing, variant calling, or paired-end analysis. tool_type: cli primary_tool: samtools measurable_outcome: Execute skill workflow successfully with valid output within 15 minutes. allowed-tools:
- read_file
- run_shell_command
Alignment Sorting
Sort alignment files by coordinate or read name using samtools and pysam.
Sort Orders
| Order | Flag | Use Case |
|-------|------|----------|
| Coordinate | default | Indexing, visualization, variant calling |
| Name | -n | Paired-end processing, fixmate, markdup |
| Tag | -t TAG | Sort by specific tag value |
samtools sort
Sort by Coordinate (Default)
samtools sort -o sorted.bam input.bam
Sort by Read Name
samtools sort -n -o namesorted.bam input.bam
Multi-threaded Sorting
samtools sort -@ 8 -o sorted.bam input.bam
Control Memory Usage
samtools sort -m 4G -@ 4 -o sorted.bam input.bam
Set Temporary Directory
samtools sort -T /tmp/sort_tmp -o sorted.bam input.bam
Specify Output Format
# Output as BAM (default)
samtools sort -O bam -o sorted.bam input.bam
# Output as CRAM
samtools sort -O cram --reference ref.fa -o sorted.cram input.bam
Sort by Tag
# Sort by cell barcode (10x Genomics)
samtools sort -t CB -o sorted_by_barcode.bam input.bam
Pipe from Aligner
bwa mem ref.fa reads.fq | samtools sort -o aligned.bam
samtools collate
Group paired reads together without full sorting (faster than name sort for some workflows):
# Collate paired reads
samtools collate -o collated.bam input.bam
# With output prefix for temp files
samtools collate -O input.bam /tmp/collate > collated.bam
# Fast mode (output to stdout)
samtools collate -u -O input.bam /tmp/collate | samtools fastq -1 R1.fq -2 R2.fq -
Check Sort Order
From Header
samtools view -H input.bam | grep "^@HD"
# SO:coordinate = coordinate sorted
# SO:queryname = name sorted
# SO:unsorted = not sorted
Verify Sorted
# Check if coordinate sorted (returns 0 if sorted)
samtools view input.bam | awk '$4 < prev {exit 1} {prev=$4}'
pysam Python Alternative
Sort with pysam
import pysam
pysam.sort('-o', 'sorted.bam', 'input.bam')
Sort by Name
pysam.sort('-n', '-o', 'namesorted.bam', 'input.bam')
Sort with Options
pysam.sort('-@', '4', '-m', '2G', '-o', 'sorted.bam', 'input.bam')
Manual Sorting in Python
import pysam
with pysam.AlignmentFile('input.bam', 'rb') as infile:
header = infile.header
reads = list(infile)
reads.sort(key=lambda r: (r.reference_id, r.reference_start))
with pysam.AlignmentFile('sorted.bam', 'wb', header=header) as outfile:
for read in reads:
outfile.write(read)
Check Sort Order in pysam
import pysam
with pysam.AlignmentFile('input.bam', 'rb') as bam:
hd = bam.header.get('HD', {})
sort_order = hd.get('SO', 'unknown')
print(f'Sort order: {sort_order}')
Stream Sort from Aligner
For streaming from aligners, use shell pipes (simpler and more reliable):
import subprocess
subprocess.run(
'bwa mem ref.fa reads.fq | samtools sort -o aligned.bam',
shell=True, check=True
)
Or use pysam with a named pipe:
import os
import pysam
import subprocess
os.mkfifo('aligner.pipe')
try:
aligner = subprocess.Popen(['bwa', 'mem', 'ref.fa', 'reads.fq'],
stdout=open('aligner.pipe', 'w'))
pysam.sort('-o', 'aligned.bam', 'aligner.pipe')
aligner.wait()
finally:
os.unlink('aligner.pipe')
samtools merge
Combine multiple BAM files into one.
Basic Merge
samtools merge merged.bam sample1.bam sample2.bam sample3.bam
Merge with Threads
samtools merge -@ 4 merged.bam sample1.bam sample2.bam sample3.bam
Merge from File List
# files.txt contains one BAM path per line
samtools merge -b files.txt merged.bam
Force Overwrite
samtools merge -f merged.bam sample1.bam sample2.bam
Merge Specific Region
samtools merge -R chr1:1000000-2000000 merged_region.bam sample1.bam sample2.bam
pysam Merge
import pysam
pysam.merge('-f', 'merged.bam', 'sample1.bam', 'sample2.bam', 'sample3.bam')
Common Workflows
Align and Sort
bwa mem -t 8 ref.fa R1.fq R2.fq | samtools sort -@ 4 -o aligned.bam
samtools index aligned.bam
Re-sort by Name for Duplicate Marking
# Full workflow: sort by name, fixmate, sort by coord, markdup
samtools sort -n -o namesorted.bam input.bam
samtools fixmate -m namesorted.bam fixmate.bam
samtools sort -o sorted.bam fixmate.bam
samtools markdup sorted.bam marked.bam
Convert Name-sorted to Coordinate-sorted
samtools sort -o coord_sorted.bam name_sorted.bam
samtools index coord_sorted.bam
Extract FASTQ from Sorted BAM
# Collate first to group pairs
samtools collate -u -O input.bam /tmp/collate | \
samtools fastq -1 R1.fq -2 R2.fq -0 /dev/null -s /dev/null -
Performance Tips
| Parameter | Effect |
|-----------|--------|
| -@ N | Use N additional threads |
| -m SIZE | Memory per thread (e.g., 4G) |
| -T PREFIX | Temp file location (use fast disk) |
| -l LEVEL | Compression level (1-9, default 6) |
Optimal Settings for Large Files
# Use 8 threads, 4GB per thread, low compression for speed
samtools sort -@ 8 -m 4G -l 1 -o sorted.bam input.bam
Quick Reference
| Task | Command |
|------|---------|
| Sort by coordinate | samtools sort -o out.bam in.bam |
| Sort by name | samtools sort -n -o out.bam in.bam |
| Sort with threads | samtools sort -@ 8 -o out.bam in.bam |
| Collate pairs | samtools collate -o out.bam in.bam |
| Merge BAMs | samtools merge out.bam in1.bam in2.bam |
| Check sort order | samtools view -H in.bam \| grep "^@HD" |
| Sort + index | samtools sort -o out.bam in.bam && samtools index out.bam |
Common Errors
| Error | Cause | Solution |
|-------|-------|----------|
| out of memory | Insufficient RAM | Use -m to limit per-thread memory |
| disk full | Temp files filling disk | Use -T to specify different location |
| truncated file | Interrupted sort | Re-run sort from original |
Related Skills
- sam-bam-basics - View and convert alignment files
- alignment-indexing - Index after coordinate sorting
- duplicate-handling - Requires name-sorted input for fixmate
- alignment-filtering - Filter before or after sorting
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
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.
