One-click install
npx skills add https://github.com/shushuzn/Rairos --skill geniml-shushuzn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geniml
Source: https://github.com/shushuzn/Rairos/tree/main/skills/geniml
Command: npx skills add https://github.com/shushuzn/Rairos --skill geniml-shushuzn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Geniml turns genomic interval data (BED files) into usable machine-learning representations, so you can search, cluster, and model similarities among regions, labels, and single cells without manual feature engineering.

Core Features & Use Cases

  • Region2Vec embeddings: Learn unsupervised embeddings from BED collections for bulk region similarity, dimensionality reduction, and downstream ML features.
  • BEDspace joint embeddings: Train shared embeddings across region sets and metadata labels to enable metadata-aware queries (region→label, label→region, region→region).
  • scEmbed for single-cell ATAC-seq: Generate cell-level embeddings from scATAC-seq peak matrices for clustering, visualization, and annotation workflows.
  • Consensus Peaks (universes): Build standardized tokenization references from many experiments using CC, CCF, ML, or HMM methods.
  • Utilities: Support caching, tokenization strategies, null-model randomization, embedding evaluation, and neural search backends.

Quick Start

Use geniml to train Region2Vec embeddings by first tokenizing your BED files against a universe reference and then running Region2Vec training with the produced token folder.

Frequently Asked Questions about geniml

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate machine learning embeddings from BED files for genomic intervals?

To generate embeddings from BED files, you first tokenize your BED collections against a consensus peak universe, then train unsupervised Region2Vec models to produce vector representations for bulk region similarity and downstream ML tasks.

Can I learn single-cell ATAC-seq cell embeddings from peak matrices?

Yes, you can generate cell-level embeddings from scATAC-seq peak matrices using the scEmbed approach, which applies Region2Vec-style token training to support clustering, visualization, and cell annotation workflows.

What is a consensus peak universe and why is it needed for genomic region tokenization?

A consensus peak universe is a standardized reference built from many experiments using CC, CCF, ML, or HMM methods. It is required to tokenize genomic interval data so that BED files map to a consistent vocabulary for embedding training.

How do I perform metadata-aware similarity search across genomic region sets and labels?

You can perform metadata-aware similarity search by training BEDspace joint embeddings, which create a shared embedding space across region sets and metadata labels to enable region-to-label and label-to-region queries.

Do I need a predefined universe reference before training Region2Vec embeddings?

Yes, training Region2Vec requires a predefined universe reference. You must tokenize your BED files against this BED-derived universe to generate the token folder needed for the subsequent embedding training and inference flows.

What utilities are available for evaluating genomic region embeddings and building search backends?

Available utilities include caching, tokenization strategies, null-model randomization for statistical validation, embedding evaluation metrics, and neural search backends to index and query the trained genomic interval representations.