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.
A well-structured, largely concrete skill body: sequenced phases, five question-to-tool-chain patterns, and copy-paste tool payloads with explicit evidence grading. Its weaknesses are a monolithic layout with no reference files, some redundant or Claude-known explanatory content, and one internal contradiction (Common Mistake #1 vs Phase 1's jaspar_get_matrix) plus a missing executable Python pattern.
Suggestions
Move the per-tool API reference (parameter tables, return shapes, and library lists) into a references/ file (e.g., references/tool_reference.md) and keep SKILL.md as a workflow overview with one-line pointers, shrinking the always-loaded body.
Delete the 'Common histone marks and their meaning' table and the duplicate Enrichr-direction guidance (it already appears as Common Mistakes #4) — Claude knows histone mark biology and the duplication wastes tokens.
Fix the internal contradiction: Common Mistake #1 says to use 'jaspar_search_matrices' NOT 'jaspar_get_matrix', yet Phase 1 documents jaspar_get_matrix as a valid tool for detailed motif info; also add one concrete example of the Python analysis pattern the 'COMPUTE, DON'T DESCRIBE' section mandates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The tool parameter/return documentation is non-obvious, skill-specific knowledge that earns its tokens, but the 'Common histone marks and their meaning' table is textbook biology Claude already knows, and the Enrichr-direction guidance is stated twice (Phase 2 'IMPORTANT' and Common Mistakes #4). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not 4 because the duplication and biology primer exceed 'minor instances'. | 3 / 5 |
Actionability | Every tool has concrete parameter tables and copy-paste-ready JSON payloads (e.g., '{"search": "TP53", "limit": 5}') with documented return shapes — mostly executable guidance with minor gaps. It is not 5 because 'COMPUTE, DON'T DESCRIBE' mandates Python analysis yet no executable Python invocation pattern is shown, and Common Mistake #1 ('NOT jaspar_get_matrix') directly contradicts Phase 1, which documents jaspar_get_matrix as a valid tool; it is not 3 because the contradiction is localized and the rest is fully concrete. | 4 / 5 |
Workflow Clarity | Phases 0–7 are explicitly sequenced and the five 'Common Use Patterns' map real question shapes to ordered tool chains, with 'LOOK UP DON'T GUESS... verify library names before calling enrichr' and the T1–T4 evidence grading acting as checkpoints. It is not 5 because there are no explicit verify→fix→retry feedback loops; it is not 3 because checkpoints are explicit rather than implicit and the destructive/batch cap does not apply to read-only data retrieval. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so the full API reference for ~15 tools (~200 lines of parameters and return shapes) is inlined in a 290-line SKILL.md. Section headers are well organized, but the per-tool reference is exactly the 'content that should be separate is inline' of anchor 3. It is not 4 because moving tool API details to a references/ file would materially shrink the always-loaded body; it is not 2 because the structure is good and nothing is buried. | 3 / 5 |
Total | 14 / 20 Passed |