Content
81%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 highly actionable, well-structured skill body: ready-to-run CLI scripts with exact invocations, a clearly sequenced workflow with written inspection/iteration checkpoints, and one-level-deep references to verified bundle files. The main costs are token redundancy — basic AnnData explanation, a duplicated script listing, and a Tips section that restates pitfalls — plus undifferentiated overlapping workflow references.
Suggestions
Merge the 'Bundled Resources' scripts file listing into the 'Script Toolkit' table (or replace it with a one-line pointer) to remove the duplicated script documentation and recover ~20 lines.
Delete or trim the 'Understanding AnnData Structure' and 'Loading Data' sections to only the non-obvious notes (e.g., '.raw' here is full log-normalized expression, NOT counts) since basic AnnData structure and sc.read_* calls are delegated to the anndata skill and already known.
Cut 'Tips for Effective Analysis' items that restate the pitfalls section ('Save checkpoints', 'Run QC script first', 'Consult references as needed') and clearly state when to read references/analysis_workflow.md versus references/standard_workflow.md so their overlapping scope is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core content is dense and skill-specific (the representation/inference contracts section, the Harmony 2 transpose-bug note, '.raw' vs 'layers["counts"]' semantics), but several sections pad or duplicate: 'Understanding AnnData Structure' explains basics Claude already knows and which the description routes to the anndata skill; 'Bundled Resources' re-lists the scripts already tabulated in 'Script Toolkit'; and 'Tips for Effective Analysis' repeats pitfalls (e.g., 'Save checkpoints' ≈ 'Save intermediate results'). This matches the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor, not 2, because the essential material is non-inferable and tightly written. | 3 / 5 |
Actionability | Fully executable throughout: a complete script table with exact typical invocations, copy-paste one-shot and step-by-step command chains, a '--config params.json' reproducibility pattern, and real bundled assets to copy ('cp assets/analysis_template.py my_analysis.py'). Common cases are covered by ready-to-run CLI scripts, matching the copy-paste-ready 5 anchor. | 5 / 5 |
Workflow Clarity | The seven-step workflow is clearly sequenced, and validation/feedback checkpoints are written explicitly rather than implied: 'inspect mitochondrial fraction and counts before choosing thresholds rather than copying defaults', 'inspect results/markers/*.csv, decide labels, write a mapping JSON, then: annotate.py', 'Check PCA variance ratio', and 'Try multiple clustering resolutions'. Error-recovery guidance is also present ('Long workflows can fail partway through' → save intermediate results), matching the explicit-validation-and-feedback-loops 5 anchor. | 5 / 5 |
Progressive Disclosure | All referenced files exist and SKILL.md links are one level deep and clearly signaled ('Read references/r_interop.md for agent-run installation and conversion instructions'). Minor organization gaps remain: the script toolkit is documented twice (table in 'Script Toolkit' plus a file listing in 'Bundled Resources'), two overlapping workflow references (analysis_workflow.md vs standard_workflow.md) are not differentiated, and reference files cross-link to each other (e.g., to upstream-review.md), matching the 'minor organization gaps' 4 anchor rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |