Content
70%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, judgment-oriented QC pipeline guide with a clear sequenced workflow, explicit validation/approval gates, and a properly signaled one-level reference. Its weaknesses are verbosity in conditional phrasing and a lack of copy-paste code for the core analysis steps, which keep conciseness and actionability at the mid level.
Suggestions
Tighten conditional hedging into terse rules (e.g. collapse the repeated 'flag it / consult the user / get approval' phrasings into a single stated policy) to improve token efficiency.
Add small executable snippets for the core steps (threshold plotting on detected genes/UMIs/percent.mt, per-batch scDblFinder invocation, backed-mode AnnData handling) so the main workflow is copy-paste ready rather than tool-named only.
Consider moving the longer judgment heuristics already in the reference back into a tighter inline quick-start so the SKILL.md body stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids padding with concepts Claude already knows (no 'what is scRNA-seq' exposition), but it is dense with conditional hedging (e.g. "If another metric looks important enough to filter on, flag it as a dataset-specific issue, explain why, and consult the user before adding that extra filter") that could be tightened, matching the level-2 'mostly efficient but could be tightened' anchor rather than the lean level-3 bar. | 2 / 3 |
Actionability | Concrete tool names (scDblFinder, scVI, Scanpy, MapMyCells, cell_type_mapper) and one executable runner command give specific guidance, but the core workflow steps lack copy-paste-ready code for plotting, thresholding, and integration, matching the level-2 'some concrete guidance but incomplete' anchor rather than the fully-executable level-3 anchor. | 2 / 3 |
Workflow Clarity | A clearly sequenced 7-step workflow with explicit validation/approval gates ("consult the user before adding that extra filter", "surface the blocker explicitly or get user approval", "Remove or flag artifact clusters only with explicit evidence"), checkpoints after major stages, a deliverables checklist, and runner blocker reporting match the level-3 anchor for clear sequence with explicit validation; the destructive/batch operations are gated so the level-2 cap does not apply. | 3 / 3 |
Progressive Disclosure | A single clearly-signaled, one-level-deep reference ("Read references/qc-annotation-umap-heuristics.md before picking thresholds…", re-listed in Resources) that is verified to exist, with the body acting as a concise overview pointing to detailed heuristics, matches the level-3 anchor rather than the inline-monolithic level-2 case. | 3 / 3 |
Total | 10 / 12 Passed |