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-structured instructional skill: fixed step order, explicit pre-output consistency checks with revision loops, verbatim templates, and a clean one-level-deep reference bundle verified on disk. The main cost is token efficiency — the Hard Rules section substantially duplicates the Execution steps and could be folded into them.
Suggestions
Collapse the 23-item Hard Rules section into the Execution steps they restate (e.g., merge Hard Rules 15/17/20/21/22/23 into Steps 7 G, C.5, I, and D), keeping only genuinely global rules not already stated inline — this would remove the conciseness drag without losing enforcement.
State each rule once at its point of use and drop the verbatim repetitions (the Dataset Disclaimer text appears twice; the 'strict subset of Lite' requirement appears three times) in favor of a single canonical statement with a short cross-reference.
Trim the duplicated forbidden-claim lists in Step 5 by merging the two bullet blocks (dependency inconsistencies and public-bioinformatics-only forbidden claims) into one consolidated checklist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and domain-specific — it does not explain concepts Claude already knows — but it could be tightened noticeably: the 23-item Hard Rules section restates requirements already fully specified in the Execution steps (e.g., the Dataset Disclaimer appears verbatim in Step 7 D and again as Hard Rule 22; Section G subsetting appears in Step 7 G, Hard Rule 15, and Hard Rule 17; dependency rules in Step 5 recur as Hard Rules 16, 18, 19). This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' — duplication exists but there is no conceptual padding. Not 2 because nothing teaches known general concepts; the bulk is skill-specific operating procedure. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: a fixed 7-step execution order, a pattern-selection table with explicit 'When to Use' criteria, a literal redirect message to output for out-of-scope requests, a verbatim Dataset Disclaimer line, concrete method-choice rules ('use DESeq2 (recommended) for raw count data, and use limma for non-count expression matrices'), explicit dependency formulas, and a fully specified A–J output-section structure including the six required self-review elements. Specific examples and templates cover the common cases; this matches the top anchor for an instruction skill. | 5 / 5 |
Workflow Clarity | The 7 steps are always run in order, and Step 5 is an explicit pre-output validation gate with a feedback loop: 'perform an internal dependency consistency check' with a concrete checklist, and 'If any dependency inconsistency is found, revise the plan before outputting'. Step 4.5 adds a verification gate for citations ('Never fabricate citations', 'do not list it as a formal reference'). This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'. | 5 / 5 |
Progressive Disclosure | SKILL.md acts as a clear overview and all detail is pushed to eight well-signaled reference files (study-patterns, workload-configurations, literature-retrieval-and-citation, workflow-step-template, analysis-modules, method-library, figure-deliverable-plan, validation-evidence-hierarchy) — all of which exist in ./references/ and contain no nested references, so navigation is one level deep as the top anchor requires. Each link is clearly labeled ('→ Detailed pattern logic: …'), and the inline content (input validation, pattern table, config table, output sections) is the appropriate core procedure rather than misplaced detail. | 5 / 5 |
Total | 18 / 20 Passed |