Content
63%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 well-structured, mostly actionable CRISPR-screen workflow with explicit phases, thresholds, and validation checkpoints, but it carries some redundant background prose and its progressive-disclosure is undermined by five missing referenced files.
Suggestions
Trim the Overview/intro paragraph and the 'Domain Reasoning' background; keep only skill-specific thresholds and tool conventions to tighten conciseness.
Either create the five missing See Also files (ANALYSIS_DETAILS.md, USE_CASES.md, EXAMPLES.md, QUICK_START.md, FALLBACK_PATCH.md) or remove the dead links so navigation is not broken.
Define or point to the undefined Quick Start helpers (load_sgrna_counts, filter_low_count_sgrnas, mageck_gene_scoring, etc.) so the example code is fully executable rather than calling opaque functions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and skill-specific (tool names, thresholds, conventions), but the Overview paragraph and intro restate scope already covered by RULE ZERO and the phase list, and the 'Domain Reasoning' section is discursive background Claude largely knows. | 3 / 5 |
Actionability | Quick Start gives concrete Python, tool calls are paired with specific parameters, and thresholds (LFC < -1.0, delta-LFC > 1.5, p < 0.001) are explicit; minor gaps come from helper functions (load_sgrna_counts, mageck_gene_scoring) being called but never defined. | 4 / 5 |
Workflow Clarity | The 8-phase workflow is clearly sequenced, RULE ZERO is an explicit validation checkpoint, QC phases and the evidence-grading table provide checkpoints; the batch-analysis validate->fix->retry loop on the core re-analysis is only implicit rather than a hard gate. | 4 / 5 |
Progressive Disclosure | Structure and a 'See Also' section signal one-level-deep references, and the scripts/ gene-set bundle is real and correctly referenced, but five of the six See Also files (ANALYSIS_DETAILS.md, USE_CASES.md, EXAMPLES.md, QUICK_START.md, FALLBACK_PATCH.md) do not exist in the bundle, breaking navigation. | 3 / 5 |
Total | 14 / 20 Passed |