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 well-organized, prescriptive skill body for a genuinely multi-stage pipeline: the sequence is clear, tools are named, provenance and validation artifacts are required deliverables, and the single reference file is real and one level deep. Main weaknesses are partial duplication between the body and the reference file, the absence of explicit retry/recovery loops, and an embedded-runner path that is not shipped in the bundle.
Suggestions
Trim the workflow bullets that restate reference-file content (marker-panel selection, memory practices, plot legibility) into short pointers so each fact lives in one place.
Add an explicit feedback loop for QC review (e.g., 'if a cluster inspection or threshold-justification plot looks wrong, revise the threshold and re-run the filter, recording both attempts').
Either ship plugins/ngs-analysis/scripts/run_scrnaseq_post_count_qc.py in the bundle (e.g., under scripts/) or note explicitly that the runner lives in an external plugin so the path is not mistaken for a bundled file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense policy guidance that mostly adds non-obvious, project-specific rules ('Use scDblFinder... run it per batch', 'Avoid whole-object copies... use views, backed mode') rather than explaining concepts Claude already knows. It is not level 5 because several workflow bullets (marker-panel selection, memory practices, plot legibility) duplicate material in references/qc-annotation-umap-heuristics.md and could be trimmed to pointers. | 4 / 5 |
Actionability | Mostly actionable: one fully executable command ('python plugins/ngs-analysis/scripts/run_scrnaseq_post_count_qc.py --input-dir path/to/scrna_bundle') plus concrete tool-level directives (scDblFinder per batch, passes_QC column, MapMyCells/cell_type_mapper, scVI vs PCA decision criteria). Not level 5 because the core workflow steps have no example code or command, and the runner path referenced is not present in the skill's bundle. | 4 / 5 |
Workflow Clarity | A clearly sequenced 7-step workflow (thresholds -> QC -> latent space -> annotation -> marker panel -> UMAP -> scaling) with most checkpoints present: threshold-justification plots, per-filter QC summary counts, cluster inspection before downstream steps, provenance manifests, and stage checkpoints. Not level 5 because there is no explicit validate -> fix -> retry loop (e.g., what to do when a threshold plot or cluster inspection fails review); verification exists but error-recovery feedback loops are implicit. | 4 / 5 |
Progressive Disclosure | Good structure: a 'Start Here' pointer and a Resources section clearly signal the single one-level-deep reference (references/qc-annotation-umap-heuristics.md, verified to exist, with no nested references inside it), and detailed heuristics are appropriately split out. Not level 5 because the split is not clean — several topics appear both inline in SKILL.md and in the reference file — and the runner script path 'plugins/ngs-analysis/scripts/run_scrnaseq_post_count_qc.py' is not part of the bundle. | 4 / 5 |
Total | 16 / 20 Passed |