Content
60%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 content is a well-organized instruction skill with a clear 7-step workflow, explicit validation checkpoints, and good one-level-deep progressive disclosure into six real reference files. It is held back by verbosity/repetition, instructional rather than executable method guidance, and two orphaned bundle files not surfaced from the body.
Suggestions
Deduplicate the no-fabrication guidance between Step 4.5, Step 5, and Hard Rule 15, keeping it in one authoritative place and cross-referencing it.
Link the two currently orphaned reference files (figure-deliverable-plan.md, validation-evidence-hierarchy.md) from Sections E and F so all prepared materials are discoverable.
Add a few concrete, runnable specifics (e.g. a representative DESeq2/limma command skeleton or the exact overlap-formula evaluation step) so the core plan is more directly executable rather than fully delegated to reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and well-structured but includes padding and mild repetition — e.g. the literature rules in Step 4.5 and Hard Rule 15 both restate 'Never fabricate... output a search strategy', and Step 5's formula examples overlap the Hard Rules — so it could be tightened without losing meaning. | 3 / 5 |
Actionability | Guidance is concrete on structure (mandatory output sections, formula notation like 'same-direction DEG overlap ∩ PPI hubs') but largely instructional rather than executable: there is no runnable code, no exact tool commands, and methods are named without parameters or commands, so key execution details are offloaded to reference files. | 3 / 5 |
Workflow Clarity | The 7-step sequence is clearly ordered with an explicit mandatory dependency-consistency checkpoint (Step 5) and a self-critical risk review; the main gap is that Step 7's output is validated only by internal logic rather than an external verify/feedback loop, leaving minor validation gaps. | 4 / 5 |
Progressive Disclosure | The body is an overview that signals six one-level-deep reference files via clear '→ ...: [references/x.md](references/x.md)' links, and those files do not nest further (verified no cross-references inside them); however two bundle files (figure-deliverable-plan.md, validation-evidence-hierarchy.md) are not linked from the body, a minor navigation gap. | 4 / 5 |
Total | 14 / 20 Passed |