Content
80%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, highly actionable body with copy-paste code and clean progressive disclosure to two real reference files. The main gap is workflow clarity: the batched whole-slide workflow lists steps but does not weave an explicit validate/verify checkpoint into the sequence, so it sits at the rubric's batch-operation cap of 3.
Suggestions
Add an explicit validation/verification step to the whole-slide workflow (e.g. '4. Verify: check the tiles-by-genes matrix has no all-NaN rows and every tile has coordinates before assembling AnnData; re-run failed batches if found'), turning it into a validate→fix→retry loop.
Trim over-explanation Claude already knows, such as 'unsqueeze(0) adds the batch dimension' and the LoRA/cross-attention/router architecture paragraph in the Overview, unless those details change how the skill is invoked.
Fold the existing require_tile size check and unknown-symbol KeyError handling into the workflow steps as named checkpoints so validation is part of the sequence rather than a separate section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean with executable signal density, but includes a few explanations Claude already knows such as 'unsqueeze(0) adds the batch dimension' and the model-architecture paragraph in the Overview that goes beyond what is needed to use the skill. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance throughout: install command, huggingface-cli login, from_pretrained/predict_genes calls, a require_tile validator, a load_deepspotm lazy-import helper, and an embedding-source table covering the common cases. | 5 / 5 |
Workflow Clarity | The whole-slide workflow is a clear numbered sequence (tile with histolab, stack batches, predict_genes per batch, concatenate into a matrix), but the batch workflow itself has no explicit validation/verification checkpoint inside the steps; per the rubric, a batch operation missing validation caps this at 3 even though tile-size and unknown-symbol checks exist elsewhere. | 3 / 5 |
Progressive Disclosure | Clear overview with well-signaled, one-level-deep references — 'references/api.md' and 'references/whole_slide.md' (both verified to exist) — and a 'Detailed references' section stating what each file contains; core usage is inline while the full API and slide-scale loop are split out. | 5 / 5 |
Total | 17 / 20 Passed |