Content
86%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 content is highly actionable with a complete runnable example and an excellent one-level-deep reference structure. Its main weakness is conciseness: the Implementation Details section restates variational-inference fundamentals Claude already knows, and the inline example commentary could be trimmed.
Suggestions
Trim the 'Implementation Details' section: drop the restatement of VAE / amortized-inference basics (the 'Core approach' and 'Training loop' bullets) and keep only scvi-tools-specific operational guidance.
Reduce inline comments in the example block to the minimum needed to clarify scVI-specific args (layer='counts', batch_key, covariate keys); remove generic explanatory comments.
Add a brief post-train validation checkpoint (e.g. assert the latent representation is finite / check training converged) to lift workflow_clarity from 4 to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient (terse bullets, one runnable example), but the 'Implementation Details' section partially re-explains VAE/amortized-inference basics Claude already knows and the example carries verbose inline commentary; above a 3 because most content earns its place, below a 5 due to these trims being available. | 4 / 5 |
Actionability | Provides a fully executable, copy-paste-ready scVI pipeline (setup_anndata -> train -> get_latent_representation / get_normalized_expression), model save/load, and install commands covering the common case, matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The numbered load->preprocess->register->train->extract->downstream sequence is clear and concrete, but there is no explicit validation checkpoint (e.g. confirm convergence / non-NaN latent) after training; above a 3 because the sequence is well-defined, below a 5 because a checkpoint is missing. | 4 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled, one-level-deep references split by modality (references/models-*.md, differential-expression.md, theoretical-foundations.md), all of which are real files, matching the clear-overview anchor. | 5 / 5 |
Total | 18 / 20 Passed |