Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with an explicit 8-phase workflow and real library calls, but it is over-long, includes undefined placeholder functions, lacks validation feedback loops beyond QC, and keeps everything inline rather than splitting detail into reference files.
Suggestions
Move the ~100-line sample report (lines 591-698) and per-phase code detail into reference files under ./references/ and link to them one level deep, leaving SKILL.md a lean overview.
Replace or implement undefined helpers ('detect_pattern_type', 'extract_signatures') and verify cell2location/scanpy API calls so the code is copy-paste executable rather than pseudocode.
Add explicit validate→fix→retry checkpoints to the clustering and deconvolution phases, mirroring the QC feedback loop, and trim duplicated trigger/capability lists that restate the description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly executable but padded: a ~100-line fully-fleshed sample report (lines 591-698), trigger/capability lists that duplicate the description, and docstrings explaining concepts Claude already knows (Moran's I semantics). Not a 3 because not every token earns its place; not a 1 because the code is concrete rather than abstract padding. | 2 / 3 |
Actionability | Provides real scanpy/squidpy/cell2location calls, but several functions call undefined placeholders ('detect_pattern_type', 'extract_signatures') and use questionable API calls ('mod.get_cell_type_fractions()', passing a Series to sc.pl.spatial color=), leaving guidance incomplete rather than copy-paste ready. | 2 / 3 |
Workflow Clarity | The 8-phase workflow is clearly sequenced with an ASCII diagram and per-phase objectives, but explicit validate→fix→retry feedback loops appear only in Phase 1 QC; later heavy steps (clustering, deconvolution) lack checkpoints, capping clarity at 2. | 2 / 3 |
Progressive Disclosure | No bundle files exist and SKILL.md is a monolithic 789-line document; the full sample report and detailed phase code that belong in separate reference files are inline. It is well-sectioned (not poorly organized), so it sits at 2 rather than 1. | 2 / 3 |
Total | 8 / 12 Passed |