Content
92%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 is a disciplined operational document: a pinned tested environment, copy-paste-ready commands covering both model modes and loom import, a validated step sequence with embedded diagnostics and error recovery, and a well-split two-file bundle. Its only weakness is mild caveat-restatement and generalized data-hygiene prose that could be tightened for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining known concepts and stays dense with non-obvious version-specific caveats, but repeats cautions in multiple phrasings ("Never use logged, scaled, residualized, or batch-corrected values as counts. Numerical inspection alone cannot establish that data are raw") and includes general data-hygiene guidance ("Inspect per-library/cluster coverage, doublets, ambient RNA") that could be trimmed. This is anchor 4 (efficient with minor trim opportunities), not anchor 5, where every token would earn its place. | 4 / 5 |
Actionability | Fully executable guidance throughout: a pinned `uv pip install` command, two complete CLI invocations with all flags, exact read calls (`ad.read_h5ad`, `ad.io.read_loom('counts.loom', X_name='spliced', sparse=True)`), exact API calls (`scv.pp.moments(adata, n_neighbors=None)`, `recover_dynamics(var_names='all')`), and a runnable post-run inspection block. It clearly matches anchor 5; the only gap — the inspection snippet assumes the run's `adata` is in scope — is trivial and covered by context. | 5 / 5 |
Workflow Clarity | A clear 7-step numbered sequence with explicit validation checkpoints ("Validate layers, IDs, model compatibility and grouping; refuse previously generated moments/velocity", "Require usable genes and a nonempty velocity graph", diagnostics recorded in `uns['velocity_workflow']['diagnostics']`), plus a problem→action troubleshooting table and pre-run input-contract and post-run evidence-inspection checklists. This matches anchor 5 (explicit validation steps, feedback loops, checklists); anchor 4 would require missing checkpoints. | 5 / 5 |
Progressive Disclosure | Two one-level-deep bundle references, both real files, clearly signaled with purpose: "[model reference](references/velocity_models.md) for assumptions, transition probabilities, and an optional CellRank handoff" and "[bundled script](scripts/rna_velocity_workflow.py)". Theory is appropriately split into the 184-line reference (which itself contains no further nested references), implementation into the 251-line script, and operations kept in SKILL.md. Matches anchor 5: clear overview, well-signaled references, appropriate split. | 5 / 5 |
Total | 19 / 20 Passed |