Home / pku-yuangroup / openai4s · skills/bioskills/bio-alignment-files-alignment-indexing/SKILL.md · GitHub

bio-alignment-indexing skillA

bio-alignment-indexing is agent-read markdown (skill) from pku-yuangroup/openai4s: Create and use BAI/CSI indices for BAM/CRAM files using samtools and pysam. Use when enabling random access to alignment files or fetching specific genomic regions..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

## Version Compatibility

Reference examples tested with: pysam 0.22+, samtools 1.19+

Before using code patterns, verify installed versions match. If versions differ:
- Python: `pip show <package>` then `help(module.function)` to check signatures
- CLI: `<tool> --version` then `<tool> --help` to confirm flags

If code throws ImportError, AttributeError, or TypeError, introspect the installed
package and adapt the example to match the actual API rather than retrying.

# Alignment Indexing

Create indices for random access to alignment files using samtools and pysam.

**"Index a BAM file"** -> Create a .bai/.csi index enabling random access to genomic regions.
- CLI: `samtools index file.bam`
- Python: `pysam.index('file.bam')`

## Index Types

| Index | Extension | Max contig | Bin shift | When required |
|-------|-----------|-----------|-----------|---------------|
| BAI | `.bai` / `.bam.bai` | 2^29 bp ≈ 537 Mbp | fixed (16 kb) | Default for human, mouse, fly, fish |
| CSI | `.csi` / `.bam.csi` | 2^(min_shift + depth*3) | configurable via `-m` | **Required** for any contig >537 Mbp |
| CRAI | `.crai` / `.cram.crai` | chunk-based | n/a | CRAM only |
…

Read the whole file at its exact version.

How to install

Latest version
mdr add pku-yuangroup/openai4s/bio-alignment-indexing@git:20260821.2d1b678
Exact content
mdr add pku-yuangroup/openai4s/bio-alignment-indexing@sha256:1a0155e83a68c52d

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_cdkmxk3dld5gkcqw.svg)](https://markdownregistry.com/a/art_cdkmxk3dld5gkcqw)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260821.2d1b678 latest2026-08-21 2d1b678 9,961 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9961 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

pku-yuangroup/openai4s · 586 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cdkmxk3dld5gkcqw
GET https://markdownregistry.com/api/v1/resolve?ref=pku-yuangroup/openai4s/bio-alignment-indexing
GET https://markdownregistry.com/api/v1/blob/1a0155e83a68c52d593ba3de7f66e9a993f67bc47cce718832a7adca1bd44368

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from pku-yuangroup/openai4s

AGENTS.md agents
pku-yuangroup/openai4s · AGENTS.md
git:20260706.f0fd27c · audit B · 586 stars
CLAUDE.md claude
pku-yuangroup/openai4s · CLAUDE.md
git:20260916.bb0d860 · audit B · 586 stars
admet_genetic skill
pku-yuangroup/openai4s · skills/admet_genetic/SKILL.md · ADMET-guided genetic molecule optimization workflow from seed SMILES; use when the agent needs to build or run an…
git:20260828.e9753be · audit A · 586 stars
alphafold2 skill
pku-yuangroup/openai4s · skills/alphafold2/SKILL.md · Predict protein structure for monomers and multimers with AlphaFold2 via the ColabFold runner (Mirdita et al. 2022…
git:20260828.e9753be · audit A · 586 stars
audit-dataset skill
pku-yuangroup/openai4s · skills/audit-dataset/SKILL.md · Audit tabular datasets before analysis or training for schema drift, missing values, duplicate rows or IDs, target…
git:20260828.e9753be · audit A · 586 stars
bioprobench skill
pku-yuangroup/openai4s · skills/bioprobench/SKILL.md · Score an LLM's biological-protocol reasoning on the BioProBench benchmark: protocol QA, step ordering, error detection…
git:20260828.e9753be · audit A · 586 stars
bio-alignment-io skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-alignment-io/SKILL.md · Read, write, and convert multiple sequence alignment files using Biopython Bio.AlignIO. Supports Clustal, PHYLIP…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-trimming skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-alignment-trimming/SKILL.md · Trim multiple sequence alignments using ClipKIT, trimAl, BMGE, Divvier, or HMMcleaner with mode selection guidance per…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-amplicon-clipping skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-amplicon-clipping/SKILL.md · Trim PCR primers from aligned reads in amplicon-panel BAMs using samtools ampliconclip. Use when processing SARS-CoV-2…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-filtering skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-filtering/SKILL.md · Filter alignments by flags, mapping quality, and regions using samtools view and pysam. Use when extracting specific…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-sorting skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-sorting/SKILL.md · Sort alignment files by coordinate or read name using samtools and pysam. Use when preparing BAM files for indexing…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-validation skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-validation/SKILL.md · Validate alignment quality with insert size distribution, proper pairing rates, GC bias, strand balance, and other…
git:20260821.2d1b678 · audit A · 586 stars

Every file in pku-yuangroup/openai4s

Browse by kind, by grade A, or by owner.