CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

geniml

This skill should be used when working with genomic interval data (BED files) for machine learning tasks. Use for training region embeddings (Region2Vec, BEDspace), single-cell ATAC-seq analysis (scEmbed), building consensus peaks (universes), or any ML-based analysis of genomic regions. Applies to BED file collections, scATAC-seq data, chromatin accessibility datasets, and region-based genomic feature learning.

69

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Well-structured, actionable skill body with clean progressive disclosure into five real reference files and clearly sequenced workflows. The main weaknesses are redundant advisory sections that duplicate capability guidance and small executable defects (duplicated "uv uv" in install commands, inconsistent adata handling in the scATAC example).

Suggestions

Remove the "When to Use Which Tool" section — its content duplicates the "Use for" bullets already present in each Core Capabilities subsection — and trim "Related Projects" to a single line, cutting ~40 lines of redundant body content.

Fix the non-executable command "uv uv pip install geniml" (duplicated "uv") and make the scATAC pipeline consistent by passing the loaded adata object rather than re-reading 'scatac_data.h5ad' in tokenize_cells.

Fold generic Best Practices items ("Record parameters and random seeds", "Experiment with embedding dimensions") into the capability reference files, and add an explicit tokenization-coverage check as the first step of each training pipeline so validation is a workflow gate rather than advisory text.

DimensionReasoningScore

Conciseness

Mostly efficient — the capability sections and code pipelines earn their tokens — but there is noticeable redundancy: the "When to Use Which Tool" section repeats the "Use for" bullets already given under each capability (e.g. "Use BEDspace when: Metadata labels available..." duplicates "Metadata-aware searches"), "Related Projects" lists ecosystem projects with no actionable guidance, and "Best Practices" includes generic advice like "Record parameters and random seeds for reproducibility". This fits anchor 3 (mostly efficient but some unnecessary explanation, could be tightened) rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Guidance is largely executable: complete Python pipelines (hard_tokenization → region2vec → evaluate_embeddings; tokenize_cells → ScEmbed → scanpy) and concrete CLI commands with flags (--cutoff 5 --merge 100 --filter-size 50). Not a 5 because of small defects that break copy-paste readiness: the install commands read "uv uv pip install geniml", and the scATAC pipeline loads adata via scanpy then passes the file path again to tokenize_cells — minor gaps rather than vague direction, so anchor 4 fits.

4 / 5

Workflow Clarity

Workflows are clearly sequenced with numbered steps ("1. Tokenize BED files using a universe reference / 2. Train Region2Vec model / 3. Generate embeddings") and checkpoints exist: tokenization coverage validation (">80% ideal"), a `geniml universe evaluate` step, and a Troubleshooting section with error→fix loops ("Adjust p-value threshold (try 1e-6 instead of 1e-9)"). Not a 5 because validation steps are advisory rather than built into the pipelines themselves (the Python examples proceed from training to evaluation with no explicit verify-before-proceed gate), which is a minor gap consistent with anchor 4.

4 / 5

Progressive Disclosure

The body is a clear overview with five well-signaled, one-level-deep references — "See `references/region2vec.md`", "See `references/bedspace.md`", etc. — all of which exist, and inspection of the bundle confirms no nested pointers (reference files contain no further .md links). Each major capability is split into its own reference file while getting-started pipelines stay inline, matching the top anchor.

5 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

Excellent description: concrete named capabilities, explicit "use when" trigger guidance with natural synonyms, third-person voice, and a distinct niche. It follows the top-anchor pattern closely with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete, named actions: "training region embeddings (Region2Vec, BEDspace)", "single-cell ATAC-seq analysis (scEmbed)", "building consensus peaks (universes)", each with the specific tool that performs it. This matches the top anchor (multiple specific concrete actions, comprehensive coverage); it is not a 4 because coverage of the package's capabilities is explicit and named rather than having minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" via named capabilities (train region embeddings, scATAC-seq analysis, build consensus peaks) and the "when" via "This skill should be used when working with genomic interval data (BED files)... Use for... Applies to...". Voice is third person ("This skill should be used"), so no person penalty applies; the explicit trigger clauses place it at the top anchor rather than anchor 4.

5 / 5

Trigger Term Quality

Natural trigger terms with synonyms are covered: "BED files", "scATAC-seq data" / "single-cell ATAC-seq", "chromatin accessibility datasets", "region embeddings", "consensus peaks", "genomic regions". This mirrors the anchor-5 example (PDF files, PDFs, forms, .pdf) with synonym-level coverage; a 4 would be missing natural variations, but ATAC-seq/scATAC-seq and BED/genomic-intervals variations are all present.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and specific — genomic-interval ML on BED files — with distinct triggers (BED, scATAC-seq, consensus peaks, region embeddings) that would not fire for unrelated skills. Unlike anchor 4 ("minor overlap risk with closely related skills"), the domain and named methods make mis-triggering unlikely.

5 / 5

Total

20

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/ml-training/geniml/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.