Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A thorough, highly actionable reference with real endpoints and copy-paste code, but it is verbose and monolithic: workflows lack validation checkpoints and the existing scripts/ bundle files are never linked from the body.
Suggestions
Move the long per-dataset code blocks into scripts/ (e.g. download_cosmic.py, parse_msigdb.py, build_ppi_network.py) and reference them from the body so SKILL.md stays a lean overview.
Add explicit validation checkpoints to the workflows (e.g. verify downloaded file size/row count before parsing; assert expected columns exist).
De-duplicate parse_gmt and strip the per-function print() debugging to reduce token load.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~560-line body is mostly efficient but padded with print-debugging in nearly every example and a duplicated parse_gmt function (Quick Start vs. section 6), so it could be tightened to earn its tokens. | 2 / 3 |
Actionability | Code is concrete and copy-paste ready with real endpoints (e.g. "https://gtexportal.org/api/v2", QuickGO URL), actual column names, and documented download URLs, giving specific executable guidance throughout. | 3 / 3 |
Workflow Clarity | Three "Typical Workflows" give a sequence, but none include validation checkpoints, and batch/large-data operations (30GB COSMIC, network builds) lack explicit verify-then-proceed loops, capping this at 2. | 2 / 3 |
Progressive Disclosure | Section structure is clear, but all code is inline (monolithic) while three scripts/ bundle files exist and are never referenced or signaled from the body, so content that should be separate stays inline and the bundle is orphaned. | 2 / 3 |
Total | 9 / 12 Passed |