Content
78%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.
Well-structured, highly actionable content with excellent progressive disclosure — an overview body pointing to real, one-level-deep reference files, plus a fully executable canonical workflow. The main weakness is redundancy and re-explanation of known concepts (theoretical foundations, repeated 'raw counts' guidance, duplicated modality lists).
Suggestions
Replace the 'Theoretical Foundations' bullet list (variational inference, VAEs, amortized inference) with a single pointer to references/theoretical-foundations.md — these are concepts Claude already knows.
Deduplicate guidance: state 'use raw counts, not log-normalized' once (the code comment or Key Design Principles) instead of three times, and merge the overlapping modality lists in 'When to Use This Skill' and 'Core Capabilities'.
Add a light validation checkpoint to the workflow, e.g. checking training history/convergence and confirming the latent representation shape before running sc.pp.neighbors, to strengthen the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient (compact model bullet lists that point to reference files), but it includes unnecessary material: the 'Theoretical Foundations' section re-explains variational inference, VAEs, and amortized inference — concepts Claude already knows — where a one-line pointer to the reference file would do, and guidance like 'use raw counts' appears three times (code comment, 'Key Design Principles', and 'Best Practices'), while the modality list appears in both 'When to Use This Skill' and 'Core Capabilities'. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trimming anchor at 4. | 3 / 5 |
Actionability | The 'Typical Workflow' is a complete, copy-paste-ready script using the real API (scvi.model.SCVI.setup_anndata through sc.pp.neighbors/umap/leiden), and the DE, save/load, batch-correction, and installation examples are all fully executable with real arguments and inline guidance ('mode="change"', 'delta=0.25', 'layer="counts"'). This matches the 'fully executable, copy-paste ready, covers common cases' anchor. | 5 / 5 |
Workflow Clarity | The typical workflow is a clearly sequenced 6-step pattern (load/preprocess → setup_anndata → train → extract → store → downstream) presented as runnable code with step comments, and it generalizes across models via the 'setup → train → extract' API principle. It stops short of 5 because there are no validation checkpoints or error-recovery guidance (e.g., checking training convergence or verifying the latent representation before downstream analysis), though training is not a destructive/batch operation so the 3-cap does not apply. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview: every model category is a short bullet list clearly signaled with 'See references/<file>.md for:', and all 8 referenced files exist, contain substantial standalone content, and are exactly one level deep (no references-to-references). Detailed material (model docs, DE methodology, workflows, theory) is appropriately split out, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 17 / 20 Passed |