Geniml Genomic Interval ML Workflow Guide
A Geniml-focused skill that validates BED/universe contracts and plans Region2Vec, scEmbed, and consensus-universe runs with an audit-first mindset.
Data & AnalyticsAdvanced★ 33,030⑂ 3,248AI score 8/10Last updated: Aug 9, 2026
What it does
This skill acts as the safety gate and planning layer for Geniml, the machine-learning toolkit for genomic interval sets.
- BED validation: checks the 0-based half-open convention, negative coordinates,
end <= start, unknown contigs, ends beyond contig length, and assembly/naming mismatches (GRCh38 vs GRCh38.p14,chr1vs1). The validator only proposes actions — it never rewrites your BED. - Reproducible installs: pins
geniml==0.8.4withgtars==0.9.2viauv, and pushes you to commit the lockfile plus artifact digests. - Current API map: points at module paths that actually work in 0.8.4 (
gtars.tokenizers.Tokenizer,geniml.region2vec.main.Region2VecExModel,geniml.scembed.main.ScEmbed) and flags stale docs (geniml assess→assess-universe,geniml scembedis a no-op,embedding_size→embedding_dim). - Compatibility auditing: verifies that
config.yamlvocab_size/embedding_dim, exactuniverse.bedbytes and row order, special-token IDs, and checkpoint tensor shapes all agree before loading anything. - Leakage control: requires splits by patient, donor, or biological replicate rather than by BED row or cell, with a manifest auditor to catch violations.
- Network discipline: BEDbase (
api.bedbase.org) and Hugging Face downloads require explicit approval; bundled helpers are stdlib-only and offline.
Who it's for
- Computational biologists building embeddings from ATAC-seq/ChIP-seq peak sets
- Teams running scEmbed on single-cell ATAC AnnData objects
- Pipeline engineers merging many BED files into consensus universes
- Groups that must document versions, checksums, and coordinate conventions for reproducibility
Example uses
- Pre-flight BED check: "Does data/peaks.bed satisfy the GRCh38 contract?" →
bed_validator.pyreports contig naming, out-of-bounds ends, duplicates, and a normalization plan. - Plan a Region2Vec run: give it a token Parquet (list-valued
tokenscolumn) plusuniverse.bed;embedding_plan.pybounds epochs, workers, and output size before any training command is approved. - Verify an inference bundle: before loading
models/region2vec, runmodel_artifact_inspector.pyandtokenizer_compatibility.pyto confirm vocab size, special tokens, and assembly all line up.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/geniml folder from the GitHub repo K-Dense-AI/scientific-agent-skills into my ~/.claude/skills/geniml/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas && mkdir -p ~/.claude/skills && cp -r /tmp/sas/skills/geniml ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repository:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Copy the skill into your Claude Code skills folder:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/geniml ~/.claude/skills/ - Confirm the
references/docs andscripts/helpers came along with it. - Install Python 3.12 and
uvif needed (curl -LsSf https://astral.sh/uv/install.sh | sh). - In your project directory create the environment with pinned versions:
uv venv --python 3.12thenuv pip install "geniml[ml]==0.8.4" "gtars==0.9.2". - The bundled scripts are standard-library only, so they run immediately:
python ~/.claude/skills/geniml/scripts/bed_validator.py --help. - Restart Claude Code and try a prompt such as "use geniml to validate my BED file against GRCh38".
- Remember that any BEDbase or Hugging Face download will only proceed after you explicitly approve it.
View source on GitHub ↗License: MIT