Content
60%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, highly actionable workflow reference whose main defects are broken bundle references (all five referenced files are missing), some redundant sections that restate the description and earlier guidance, and placeholder variables in a few code examples. Fixing the missing bundle files would resolve the largest scoring drag.
Suggestions
Add the referenced bundle files (scripts/qc_analysis.py, references/standard_workflow.md, references/api_reference.md, references/plotting_guide.md, assets/analysis_template.py) or remove the references — every referenced path currently 404s, which cripples navigation and the automated QC/script entry points.
Delete the Overview section that duplicates the frontmatter description verbatim, and fold 'Tips for Effective Analysis' into 'Common Pitfalls and Best Practices' to remove redundant guidance.
Fix placeholder variables in the code examples: define `genes` in the publication-plots section and note that the differential-expression example requires a `condition` column in adata.obs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — content is dominated by lean, commented code blocks — but there is real padding: the Overview section repeats the frontmatter description verbatim, and 'Tips for Effective Analysis' restates guidance already given in 'Common Pitfalls' and 'Bundled Resources' (e.g., 'Run QC script first', 'Start with the template'). Fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than 4, since the duplication is structural, not minor. | 3 / 5 |
Actionability | The body is dominated by concrete, executable code covering loading, QC, normalization, PCA/UMAP, Leiden clustering, marker identification, annotation, and saving — largely copy-paste ready. Minor gaps keep it below 5: the publication-plots section uses an undefined variable `genes` (only `marker_genes` is defined earlier), the differential-expression example assumes an undefined `condition` column, and the qc_analysis.py invocation depends on a script not present in the bundle. | 4 / 5 |
Workflow Clarity | A clear numbered 1–7 sequence (QC → normalization → dimensionality reduction → clustering → markers → annotation → save) with most checkpoints present: 'Visualize QC metrics' before filtering, 'Check elbow plot' for PC selection, 'Try multiple resolutions' for clustering, and 'Save intermediate results'. It stays at 4 rather than 5 because destructive filtering steps lack an explicit validate-after-filtering loop — the checkpoints are advisory best-practice bullets rather than inline validation gates. | 4 / 5 |
Progressive Disclosure | References are clearly signaled and well-described (per-file purpose and 'read this when' guidance), but every referenced bundle path is broken: scripts/qc_analysis.py, references/standard_workflow.md, references/api_reference.md, references/plotting_guide.md, and assets/analysis_template.py do not exist in the bundle. Per the guideline to score against the actual bundle structure, navigation to all detailed material fails, fitting anchor 2 ('minimal structure... references are buried'/unusable) better than 3's 'references present but not clearly signaled'. | 2 / 5 |
Total | 13 / 20 Passed |