Content
77%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 concrete tool signatures, examples, and well-sequenced reasoning workflows, but it is a long monolithic single file that re-explains some known biology and does not split detail into reference files.
Suggestions
Move the per-phase tool reference (Phases 0–8) into a separate references/ file and keep SKILL.md as a classification + reasoning overview with one-level-deep links, improving progressive_disclosure and reducing per-invocation token load.
Trim or condense explanations of concepts Claude already knows (histone-mark definitions, bivalent-promoter basics, 'association ≠ causation') to operational decision rules only.
If the full tool catalog must stay inline, add a short navigation/index block at the top so Claude can jump to the relevant phase without scanning all eight sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely dense and actionable, but the ~240-line single-load body explains concepts Claude already knows (histone-mark meanings, bivalent-promoter logic, 'association ≠ causation') and inlines all eight phases of per-tool reference that could be tightened or deferred. | 2 / 3 |
Actionability | Gives exact tool names, REQUIRED parameters, defaults, and copy-paste Python snippets with result-parsing paths (e.g. result["data"]["experiments"][0]["accession"]), matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | Sequences work clearly via 'Classify the Question First' (a–d) then Phases 0–8, with reasoning checkpoints (gene-ID filtering, tissue-specificity checks, multi-layer synthesis rules) and a fallback table; operations are read-only so the destructive-batch cap does not apply. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the entire tool catalog plus reasoning sections sit in one monolithic SKILL.md over 50 lines; sections are well-headed but content that could be split into one-level-deep reference files is inlined rather than disclosed progressively. | 2 / 3 |
Total | 10 / 12 Passed |