Content
75%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 concise, well-sequenced workflow that assumes domain competence and includes pre-training verification and post-training QC checkpoints. Its main weakness is actionability: it tells Claude what to record and check but not how to execute or verify via concrete commands or code.
Suggestions
Add concrete executable examples or commands for the key actions (e.g. a minimal scVI/scANVI training snippet or a verification command) to lift actionability.
Add an explicit feedback loop after step 4 (e.g. 'If batch mixing is poor or markers are inconsistent, adjust hyperparameters/covariates and retrain') to make the validation checkpoint a true retry loop.
Introduce light subheadings (e.g. '## Inputs to record', '## Verification', '## QC checks') to improve navigation of the flat workflow list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with no concept over-explanation, assuming Claude's knowledge of scvi-tools; each line (record fields, verify environment, save artifacts, check metrics) earns its place. | 5 / 5 |
Actionability | Steps list specific items to capture and check (batch keys, label keys, marker consistency) but provide no executable code or commands; guidance is concrete in content yet incomplete in execution detail. | 3 / 5 |
Workflow Clarity | A clear five-step numbered sequence includes verification checkpoints (step 2 'Verify ... before training', step 4 'Check ...'), satisfying the batch-operation validation requirement, though an explicit feedback loop ('if metrics fail, retrain') is not stated. | 4 / 5 |
Progressive Disclosure | As a short single-file skill with no bundle files, content is reasonably organized under a 'Workflow' heading with a closing guardrail note; structure is good but flat, with minor organization gaps rather than the clean sectioned overview of a 5. | 4 / 5 |
Total | 16 / 20 Passed |