Content
57%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 delivers strong, executable code and a clear data-file reference table, but it is padded with concepts Claude already knows, has abstract workflows lacking validation, and fails to surface the existing dependency_analysis.md reference. The main levers for improvement are trimming redundant explanation and wiring up the reference file.
Suggestions
Link references/dependency_analysis.md from the body (e.g., 'See [dependency_analysis.md](references/dependency_analysis.md) for score interpretation, selectivity scoring, and synthetic-lethality/PRISM details') and move the duplicated synthetic-lethality and PRISM code there instead of inlining it.
Replace the placeholder 'https://figshare.com/ndownloader/files/...' URL with the concrete current download path or a clearly-labeled versioned pointer so the download example is runnable.
Tighten the Overview and Best Practices sections by removing restatements of what DepMap/CRISPR is and basic programming concepts Claude already knows; keep only DepMap-specific guidance.
Add explicit validation checkpoints to the workflows (e.g., check row/column counts after loading a file, confirm the target gene exists before scoring, apply FDR correction as a stated step in the synthetic-lethality workflow).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete code, but the Overview re-explains what DepMap is, the 'DepMap data is essential for' list and Core Concepts table restate concepts Claude already knows, and Best Practices prose could be tightened — matching the 'mostly efficient but could be tightened' anchor rather than the lean score-4 example. | 3 / 5 |
Actionability | Provides several copy-paste-ready Python functions (dependency lookup, downloads, selective-dependency filtering, biomarker analysis, co-essentiality), but the FILES dict uses a placeholder figshare URL and example usage is commented out, leaving minor gaps short of fully executable. | 4 / 5 |
Workflow Clarity | Three workflows give a numbered sequence, but steps are abstract ('Filter cell lines', 'Compute mean gene effect') with no validation checkpoints; for these batch/genome-wide analyses the missing validation caps workflow clarity at 3 per the batch-operations guideline. | 3 / 5 |
Progressive Disclosure | Section structure is reasonable, but a substantial references/dependency_analysis.md bundle exists and is never linked from the body, while synthetic-lethality and PRISM content is duplicated inline instead of pointed to the reference — 'references present but not clearly signaled; content that should be separate is inline'. | 3 / 5 |
Total | 13 / 20 Passed |