Content
85%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 skill body: executable main-path code with assertion-based validation, explicit error-recovery guidance, and clean one-level-deep reference files that all exist. The residual weaknesses are minor — a few over-explained asides and specialized-model workflows that require following references before any code is available.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean — terse tables, executable code, and scvi-specific caveats Claude would not know — but a few passages over-explain (e.g. 'PyTorch MPS and MLX are different backends', the detailed arXiv-fetching instructions in the citation section), sitting between 'efficient with minor trims' and 'every token earns its place'. | 4 / 5 |
Actionability | The RNA workflow, DE example, and install commands are fully executable with assertion checkpoints, but specialized-model paths (SCANVI annotation, TOTALVI, reference mapping) are pointer-only with no inline runnable example, matching 'concrete code with minor gaps' rather than full coverage of common cases. | 4 / 5 |
Workflow Clarity | The five-step Workflow section has explicit validation (step 4: 'Inspect validation history, held-out fit, seed stability, batch mixing and retention of known biology'), the code includes assertion checkpoints, and there are concrete feedback loops ('If filtering removes all expression from a cell, remove that cell or revise feature selection'; 'If the training object changes, register it again') plus a pre-flight check ('Check a small CPU fit and finite outputs... before a long run'). | 5 / 5 |
Progressive Disclosure | The body is a genuine overview: primary workflow inline, with all eight referenced files verified to exist, one level deep, clearly signaled by a bulleted per-scope list ('Read the corresponding references before using a specialized model') and targeted inline pointers to workflows, DE, and theory references. | 5 / 5 |
Total | 18 / 20 Passed |