Content
77%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 a highly actionable, well-sequenced planning skill with excellent progressive disclosure via eight clearly-linked, one-level-deep reference files. Its primary weakness is conciseness: the hard-rules section and several dependency/disclaimer/formula rules are restated across the body and reference files, creating substantial redundancy.
Suggestions
Consolidate the 23 'Hard Rules' with the corresponding Step 1–7 sections instead of restating them; keep rules inline where they apply and remove the duplicated end-of-document list.
De-duplicate the dependency/forbidden-combination rules and the Dataset Disclaimer — state each once in the relevant step and reference it, rather than repeating in Steps 5–6, hard rules, and reference files.
Tighten the YAML description into a shorter sentence or two; it currently runs as a dense wall of text trailing into '...'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 23 'Hard Rules' largely restate content already embedded in Steps 1–7, and the dependency/forbidden-combination/disclaimer/intersection-formula rules are repeated across the body, the hard-rules section, and the reference files. This is noticeably verbose with several padded, redundant sections. Not 3 because the redundancy is substantial rather than a single tighten-able spot; not 1 because it never explains concepts Claude already knows. | 2 / 5 |
Actionability | Provides a fully concrete output template (mandatory sections A–J, an 8-field step template), explicit decision rules (DESeq2 for raw counts, limma for non-count matrices), exact intersection formulas (DEG ∩ survival-associated genes ∩ PPI hubs), and specific parameter defaults (FDR<0.05, |log2FC|>1.0, AUC>0.70). For an instruction-only planner skill this is as actionable as it gets. Not 4 because there are no meaningful gaps in the executable guidance. | 5 / 5 |
Workflow Clarity | A clear 7-step sequence 'always run in order' with an explicit Step 5 dependency-consistency validation checkpoint, a 'revise before outputting' feedback loop, phase-gate deliverable checklists, and redirect-and-stop handling for out-of-scope input. Not 4 because validation checkpoints, feedback loops, and checklists are all explicitly present. | 5 / 5 |
Progressive Disclosure | Eight one-level-deep reference files (study-patterns, workload-configurations, workflow-step-template, analysis-modules, method-library, validation-evidence-hierarchy, figure-deliverable-plan, literature-retrieval-and-citation), all verified to exist and each clearly signaled in the body with markdown links; the body is an overview pointing to detailed materials with no nested reference chains. Not 4 because navigation is consistently clear and references stay exactly one level deep. | 5 / 5 |
Total | 17 / 20 Passed |