Content
85%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.
An exceptionally well-engineered orchestration skill: sequenced steps with genuine validation gates and fallbacks, copy-paste-ready templates, and a clean one-level-deep reference bundle with no orphan or nested files. The main cost is redundancy — Hard Rules 11–23 largely restate mandates already given in Steps 4.5/5 and Sections C.5/D/I, and the rule list skips number 10 (jumps 9 → 11).
Suggestions
Consolidate the duplicated mandates: fold Hard Rules 11–13 into Step 4.5/Section I, Rules 16–20 into Step 5/Section C.5, and Rule 22 into Section D, keeping a short non-redundant checklist so each rule is stated once authoritatively.
State the never-fabricate-citations rule once (Step 4.5) and have Section I reference it rather than repeating the full rules, trimming roughly 15–20 lines without losing any constraint.
Fix the Hard Rules numbering, which skips 10 (jumps from 9 to 11), so the checklist reads cleanly when used as a final pre-output verification list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with task-specific rules rather than concepts Claude already knows, but it could be tightened considerably: the no-fabricated-citations rule is stated three times (Step 4.5, Section I, Hard Rules 11–13), the dependency rules appear in Step 5, Section C.5, and Rules 16–20, and Rule 22 restates Section D's dataset disclaimer verbatim. This lands on the 'mostly efficient but could be tightened' anchor rather than 'noticeably verbose', since the repetition is deliberate compliance emphasis, not filler. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is copy-paste ready: the exact out-of-scope redirect template, the exact "Dataset Disclaimer" line, the pattern/config selection tables, explicit prioritization formulas ("DEG only / DEG ∩ MR-supported genes ∩ colocalized genes"), and a fully enumerated mandatory output structure (Sections A–J with per-section contents). No pseudocode or vague direction remains. | 5 / 5 |
Workflow Clarity | "Execution — 7 Steps (always run in order)" gives a clear sequence with real validation checkpoints: input validation with a redirect-and-stop branch, Step 5's dependency consistency check with a feedback loop ("If any dependency inconsistency is found, revise the plan before outputting"), and fallback handling ("If browsing/search is unavailable... output a search strategy + target evidence map instead"). The 23 Hard Rules double as a final checklist. | 5 / 5 |
Progressive Disclosure | The body is an orchestration overview and every deep detail lives in the bundle: all 8 referenced files (study-patterns.md, workload-configurations.md, literature-retrieval-and-citation.md, workflow-step-template.md, analysis-modules.md, method-library.md, figure-deliverable-plan.md, validation-evidence-hierarchy.md) exist, each is signaled inline at its point of use ("→ Detailed pattern logic: [references/study-patterns.md]"), and no reference file links onward, so references are exactly one level deep with no orphan files. | 5 / 5 |
Total | 18 / 20 Passed |