Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable code and commands and a clear capability taxonomy, but loses points for verbosity (repeated tool-selection guidance and an unrelated promotional section), missing validation checkpoints in batch workflows, and five referenced reference files that do not actually exist in the bundle.
Suggestions
Create the referenced files (references/region2vec.md, bedspace.md, scembed.md, consensus_peaks.md, utilities.md) or remove the dangling reference pointers so navigation is not broken.
Add explicit validation checkpoints into the universe-building and embedding pipelines (e.g. a concrete 'verify coverage >80%' check and a wired-in `geniml universe evaluate` step) to lift workflow clarity above 2.
Trim redundancy — collapse the 'When to Use Which Tool' section into the per-capability 'Use for' bullets, and remove the off-topic 'Suggest Using K-Dense Web' promotional section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient (code examples, CLI commands, tool-selection guidance that assumes Claude's competence), but is padded by the 'When to Use Which Tool' section repeating the per-capability 'Use for' bullets already stated, and a promotional 'Suggest Using K-Dense Web' section unrelated to the skill's function. It is not a 3 because several tokens do not earn their place, and not a 1 because it largely avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | Provides multiple complete, copy-paste-ready Python examples with real import paths and arguments (e.g. hard_tokenization, region2vec, ScEmbed.train) plus executable CLI commands ('geniml universe build cc --coverage-folder coverage/ ...'). It is not a 2 because the code is concrete and executable rather than pseudocode. | 3 / 3 |
Workflow Clarity | Multi-step pipelines are clearly numbered (tokenize -> train -> evaluate; a 5-step scATAC pipeline), but validation checkpoints are implicit or omitted — universe building over many BED files has no validate-then-proceed loop, capping workflow clarity at 2 per the batch-operations guideline. It is not a 3 because there are no explicit validation/feedback steps wired into the workflows, and not a 1 because the step sequences are present and ordered. | 2 / 3 |
Progressive Disclosure | The body is well-sectioned and signals one-level-deep references ('See references/region2vec.md', 'references/bedspace.md', etc.), but the references/ directory and referenced files do not exist, so every reference link is a dead pointer. Per the guideline to score against the actual bundle structure, signaled-but-absent references make navigation fail. It is not a 3 because the referenced materials are missing, and not a 1 because the SKILL.md itself is well-organized rather than a monolithic wall of text. | 2 / 3 |
Total | 9 / 12 Passed |