Content
71%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 highly actionable with executable wrappers and well-designed decision tables, and its validation discipline is strong. Its main weaknesses are visible redundancy across overlapping sections and two dangling reference links plus inlined material that would suit separate files.
Suggestions
Remove the two missing reference links (design_formula_guide.md and r_clusterprofiler_guide.md) or create the files so navigation is not broken.
Consolidate the repeated R-vs-pydeseq2 and set-operation/Venn-denominator guidance into a single authoritative section instead of restating it across 'CRITICAL', 'LOOK UP DON'T GUESS', and 'Analysis conventions'.
Move the inlined decision tables and calculation conventions (e.g., density/per-chromosome, strain-identity pinning) into reference files to slim SKILL.md toward an overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and dense with genuinely non-obvious domain gotchas, but the same guidance recurs across multiple sections (R-vs-pydeseq2 choice in 'CRITICAL', 'Analysis conventions', and 'R DESeq2 vs pydeseq2'; Venn denominators and set operations repeated in both the numbered rules and 'Analysis conventions'), which is padding Claude does not need twice. | 3 / 5 |
Actionability | Copy-paste-ready bash, python, and R commands with full arguments, shown output formats, and decision tables mapping question phrasing to the exact script line to read — fully executable across the common cases. | 5 / 5 |
Workflow Clarity | A clear sequenced primary-scripts-first flow with explicit validation checkpoints (read executed notebook first, match filters and outlier exclusions exactly, workspace isolation), but the repetition across sections slightly muddies which path is canonical, keeping it just below 5. | 4 / 5 |
Progressive Disclosure | References are one level deep and gathered in a Reference Files section, but two links point to files that do not exist (design_formula_guide.md and r_clusterprofiler_guide.md), and substantial decision-table/convention content that belongs in references is inlined directly in SKILL.md rather than split out. | 3 / 5 |
Total | 15 / 20 Passed |