Content
71%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable skill body with good progressive disclosure into verified reference files. Its main weaknesses are redundant capability coverage across three sections and a small executable typo in the install command.
Suggestions
Collapse the redundancy between 'Core Capabilities' workflows, 'Common Workflows' code, and 'When to Use Which Tool' into a single per-capability block to recover token budget.
Fix the install commands: 'uv uv pip install geniml' should be 'uv pip install geniml' (and likewise for the [ml] and git variants) so they run as written.
Add an explicit validation feedback loop to the Universe Building workflow (e.g., after `geniml universe evaluate`, state what to check and how to remediate before relying on the universe for tokenization).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient code and short descriptions, but the five capabilities are covered three times over (Core Capabilities workflows, Common Workflows code, and the "When to Use Which Tool" section), which is unnecessary repetition that could be tightened. | 3 / 5 |
Actionability | It provides concrete, mostly copy-paste-ready Python pipelines and CLI commands with real parameters, but the installation block reads "uv uv pip install geniml" — a doubled token that fails if copied verbatim — a minor executable gap. | 4 / 5 |
Workflow Clarity | Multi-step pipelines (Basic Region Embedding, scATAC, Universe Building) are clearly numbered and include evaluate steps as checkpoints, but there are no explicit validate→fix→retry feedback loops for the batch universe-building operation. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a clear overview that signals five real, one-level-deep reference files (region2vec.md, bedspace.md, scembed.md, consensus_peaks.md, utilities.md, all present in ./references/), with content appropriately split and easy to navigate. | 5 / 5 |
Total | 16 / 20 Passed |