Content
65%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 solid, well-structured skill body with strong progressive disclosure and broadly executable examples. It is held back by padded marketing/explanation sections, an install-command typo, and workflows that omit the validation checkpoints expected for batch/file-producing operations.
Suggestions
Fix the doubled command in the Python install section ("uv uv pip install gtars" -> "uv pip install gtars") and verify the RegionSet / filter_overlapping examples against references/python-api.md so the snippets are fully executable.
Trim the 'Performance Characteristics' and 'Data Formats' sections, or fold their load-bearing points into the relevant module sections, to remove marketing padding and improve conciseness.
Add explicit validation/verification checkpoints to the batch workflows (e.g., confirm output BigWig is readable, check fragment-split output counts vs. input) to raise workflow clarity above 3.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and does not over-explain genomics basics, but the repeated 'When to use' bullet lists across six modules and the marketing-flavored 'Performance Characteristics' / 'Data Formats' sections ('Native Rust performance', 'Zero-copy operations') add padding; above 2 because code examples assume Claude's competence and there is no concept-explaining filler, but below 4 due to these unnecessary sections. | 3 / 5 |
Actionability | Each module ships concrete, mostly copy-paste-ready Python and bash examples (e.g., 'gtars.igd.build_index("regions.bed")', 'gtars uniwig generate --input fragments.bed --output coverage.bw'); falls short of 5 because the install line 'uv uv pip install gtars' is a typo and a few API calls (e.g., gtars.RegionSet, filter_overlapping) are not verified against the bundled API reference. | 4 / 5 |
Workflow Clarity | Workflows 1-3 present a numbered sequence but none include validation checkpoints, and several involve batch/file-producing operations (fragment splitting, coverage generation, ML preprocessing); the rubric caps batch operations without validation at 3, and the sequence lacks explicit 'verify output' or error-recovery feedback loops that the level-4/5 anchors require. | 3 / 5 |
Progressive Disclosure | SKILL.md is a clear overview with well-signaled, one-level-deep references ('See references/overlap.md'), content appropriately split across the six real reference files that all exist on disk, and easy navigation; matches the top anchor exactly. | 5 / 5 |
Total | 15 / 20 Passed |