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

bio-reference-operations skillA

bio-reference-operations is agent-read markdown (skill) from pku-yuangroup/openai4s: Generate consensus sequences and manage reference files using samtools. Use when creating consensus from alignments, indexing references, or creating sequence dictionaries..

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: GATK 4.5+, bcftools 1.19+, 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.

# Reference Operations

Generate consensus sequences and manage reference files using samtools.

**"Prepare a reference genome"** -> Index the FASTA and create a sequence dictionary for downstream tools.
- CLI: `samtools faidx ref.fa` + `samtools dict ref.fa -o ref.dict`
- Python: `pysam.FastaFile('ref.fa')` (auto-uses .fai index)

**"Build a consensus from BAM"** -> Derive the most-supported base at each position from aligned reads.
- CLI: `samtools consensus input.bam -o consensus.fa`
- Python: iterate pileup columns and take majority base (pysam)

## samtools faidx - Index Reference FASTA

Create index for random access to reference sequences.

### Create Index
```bash
…

Read the whole file at its exact version.

How to install

Latest version
mdr add pku-yuangroup/openai4s/bio-reference-operations@git:20260821.2d1b678
Exact content
mdr add pku-yuangroup/openai4s/bio-reference-operations@sha256:485407fda65ef1ed

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_ndsyvgfm7rx3pruh.svg)](https://markdownregistry.com/a/art_ndsyvgfm7rx3pruh)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260821.2d1b678 latest2026-08-21 2d1b678 12,614 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 (12614 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_ndsyvgfm7rx3pruh
GET https://markdownregistry.com/api/v1/resolve?ref=pku-yuangroup/openai4s/bio-reference-operations
GET https://markdownregistry.com/api/v1/blob/485407fda65ef1ed627833997b415906167539a81e120c2d87c4b9e403d6fdbe

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-indexing skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-indexing/SKILL.md · Create and use BAI/CSI indices for BAM/CRAM files using samtools and pysam. Use when enabling random access to…
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

Every file in pku-yuangroup/openai4s

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