Content
75%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.
A thorough, highly actionable skill body with an excellent six-step workflow, complete executable examples, strong troubleshooting feedback loops, and well-organized one-level-deep references. Its main costs are token redundancy (the core analysis code appears nearly verbatim three times) and inline content that could be pushed to the reference files.
Suggestions
Deduplicate the load → deseq2() → DeseqStats code that repeats in Quick Start, Core Workflow Steps, and Common Analysis Patterns; keep one canonical example and make the variants diff-only.
Move the full volcano/MA plotting code to a reference file and keep only a pointer, mirroring the api_reference/workflow_guide pattern.
Embed inline validation checkpoints in the main workflow (e.g., after loading, verify counts/metadata index alignment and samples × genes orientation) rather than deferring all checks to the Troubleshooting section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient, domain-specific content with little generic explanation Claude would already know, but noticeably padded by redundancy: the same load/filter/run/contrast code appears in Quick Start, Core Workflow Steps, and again in Common Analysis Patterns, and the full volcano/MA plotting code duplicates what a reference file could hold. Not 2 because explanations are domain-specific rather than filler; not 4 because the triplicated code blocks and a ~550-line body could be materially tightened. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready code throughout: complete DeseqDataSet/DeseqStats invocations with real parameters, contrast formats, result-column semantics, plus a documented CLI script with concrete flag examples ("python scripts/run_deseq2_analysis.py --counts counts.csv ... --contrast condition treated control"). Covers the common cases end-to-end from loading through export and plotting. | 5 / 5 |
Workflow Clarity | Steps 1-6 are clearly sequenced with inputs, code, and expected outputs, and the Troubleshooting section provides error-message → diagnostic → fix feedback loops (index mismatch, full-rank design, no significant genes) plus a Key Reminders checklist. Not 5 because in-flight validation checkpoints are not embedded in the main workflow itself (e.g., no explicit sample-index/shape check immediately after loading); not 3 because diagnostics and recovery loops are explicitly present. | 4 / 5 |
Progressive Disclosure | Good structure with real, verified one-level-deep references (references/api_reference.md, references/workflow_guide.md) clearly signaled with explicit "Load these references when..." navigation guidance, plus a bundled script. Not 5 because substantial content (full visualization code, extended troubleshooting, AnnData patterns) is inlined in SKILL.md that arguably belongs in the references, and some body content duplicates the workflow guide. | 4 / 5 |
Total | 16 / 20 Passed |