Content
63%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.
The body is highly actionable — exact tool signatures, JSON examples, return shapes, common mistakes, and question-to-workflow patterns — with a coherent phase structure. Its weaknesses are moderately padded with biology Claude already knows, and a monolithic single-file layout that inlines what belongs in reference files.
Suggestions
Split the per-tool parameter/return reference (Phases 1-7) into a references/ file (e.g. tools.md), keeping SKILL.md as a lean overview with the workflow, patterns, and common mistakes.
Delete or compress the histone-mark meanings list and the direct-vs-indirect evidence primer; keep only the skill-specific evidence-grading tiers (T1-T4).
Add one-line JSON call examples for the tools currently lacking them (RegulomeDB, IntAct, BioGRID, STRING_functional_enrichment, OLS) to close the actionability gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The tool parameter blocks and Common Mistakes are genuinely non-obvious and earn their tokens, but the body also explains things Claude already knows: "H3K27ac -- Active enhancers and promoters", "H3K27me3 -- Polycomb-repressed regions", and an opening paragraph reiterating that direct binding evidence outweighs co-expression. Fits the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than 4, where over-explanation would be only minor. | 3 / 5 |
Actionability | Concrete tool names, exact parameter lists, copy-paste JSON call examples, and documented return shapes for the core tools (JASPAR, Enrichr, GTEx, STRING), plus a 'COMPUTE, DON'T DESCRIBE' mandate. Not 5 because several tools (RegulomeDB, IntAct, BioGRID, STRING_functional_enrichment, OLS, PubMed) have parameter tables but no call example or return-shape example. | 4 / 5 |
Workflow Clarity | Phases 0-7 give a clear interrogable sequence and five named use patterns map question shapes to tool chains; the 'LOOK UP DON'T GUESS' rule and the Common Mistakes list act as checkpoints. It falls short of 5 because there are no explicit result-validation steps (e.g., verifying a JASPAR matrix ID before use is stated, but no check that returned enrichment terms are meaningful), though for read-only retrieval this is a minor gap, not the score-3 cap scenario. | 4 / 5 |
Progressive Disclosure | Section headers are clean and navigable, but there are no bundle files at all — ~200 lines of per-tool API reference (parameters, returns, and the mistakes list) live inline in SKILL.md where the rubric's ideal is a lean overview pointing one level deep into references/. This is the 'content that should be separate is inline' anchor; it avoids a 2 only because the inline content is well-structured with clear headers rather than a wall of text. | 3 / 5 |
Total | 14 / 20 Passed |