Claude Skill MartBrowse skillsWhat is a Skill?
Back to list

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 & AnalyticsAdvanced33,0303,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, chr1 vs 1). The validator only proposes actions — it never rewrites your BED.
  • Reproducible installs: pins geniml==0.8.4 with gtars==0.9.2 via uv, 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 assessassess-universe, geniml scembed is a no-op, embedding_sizeembedding_dim).
  • Compatibility auditing: verifies that config.yaml vocab_size/embedding_dim, exact universe.bed bytes 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

  1. Pre-flight BED check: "Does data/peaks.bed satisfy the GRCh38 contract?" → bed_validator.py reports contig naming, out-of-bounds ends, duplicates, and a normalization plan.
  2. Plan a Region2Vec run: give it a token Parquet (list-valued tokens column) plus universe.bed; embedding_plan.py bounds epochs, workers, and output size before any training command is approved.
  3. Verify an inference bundle: before loading models/region2vec, run model_artifact_inspector.py and tokenizer_compatibility.py to confirm vocab size, special tokens, and assembly all line up.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Download 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.

  1. Open a terminal and clone the repository: git clone https://github.com/K-Dense-AI/scientific-agent-skills.git
  2. Copy the skill into your Claude Code skills folder: mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/geniml ~/.claude/skills/
  3. Confirm the references/ docs and scripts/ helpers came along with it.
  4. Install Python 3.12 and uv if needed (curl -LsSf https://astral.sh/uv/install.sh | sh).
  5. In your project directory create the environment with pinned versions: uv venv --python 3.12 then uv pip install "geniml[ml]==0.8.4" "gtars==0.9.2".
  6. The bundled scripts are standard-library only, so they run immediately: python ~/.claude/skills/geniml/scripts/bed_validator.py --help.
  7. Restart Claude Code and try a prompt such as "use geniml to validate my BED file against GRCh38".
  8. Remember that any BEDbase or Hugging Face download will only proceed after you explicitly approve it.