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 content delivers a clearly sequenced, well-validated planning workflow with strong progressive disclosure to real, one-level-deep reference files, and highly actionable output specifications. Its main weakness is redundancy: many Hard Rules and citation requirements restate step content two or three times, which inflates token cost without adding guidance.
Suggestions
Consolidate the 23 Hard Rules: drop rules that verbatim restate Step 7 sections (e.g., rules 15, 17, 22 duplicate Section G/Section D requirements) and keep only rules not already stated in the steps.
State the never-fabricate-citation requirements once (Step 4.5 or Section I) instead of three times across Step 4.5, Hard Rules 11–13, and Section I.
Include one short worked example of an 8-field workflow step in the body (or point explicitly to the template file's example) to make 'explain the logic of each decision' concretely actionable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly instructional rather than explaining known concepts, but contains pervasive redundancy: the citation rules appear three times (Step 4.5 rules, Hard Rules 11–13, Section I requirements), the Dataset Disclaimer appears in Step 7-D and again verbatim as Hard Rule 22, Section G rules repeat as Hard Rules 15/17, and endpoint formulas repeat as Hard Rule 18. Fits 'mostly efficient but... could be tightened'; not a 2 because the material is substantive rather than padded concept explanation. | 3 / 5 |
Actionability | Concrete guidance throughout: exact input format ('[cancer type] + [biomarker direction OR hub-gene direction...]'), verbatim redirect text, a pattern-selection table, config comparison table, exact dependency formulas ('DEG ∩ survival-associated genes ∩ PPI hubs'), verbatim disclaimer text, and fully specified output sections A–J. Mostly executable for an instruction-only skill with minor gaps — e.g., 'Do not merely list tool names. Explain the logic of each decision' is directive without a worked example in the body — so a 5 is not warranted. | 4 / 5 |
Workflow Clarity | Seven steps 'always run in order' with an explicit validation checkpoint: Step 5 is 'mandatory before output' with a feedback loop ('If any dependency inconsistency is found, revise the plan before outputting'), Step 4.5 is mandatory, and mandatory output sections A–J plus 23 hard rules form a checklist. Matches the top anchor (clear sequence, explicit validation, feedback loops, checklists). | 5 / 5 |
Progressive Disclosure | The body is a well-sectioned overview that appropriately pushes detail to eight existing, one-level-deep reference files, each clearly signaled ('→ Detailed pattern logic: [references/study-patterns.md]', etc.); all eight referenced paths exist in the bundle. Navigation is easy and the split is appropriate, matching the top anchor; the inline Hard Rules redundancy is a conciseness issue rather than a structural one. | 5 / 5 |
Total | 17 / 20 Passed |