Content
82%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-sequenced skill with verified, clearly-signaled bundle resources. Main gaps are redundancy across the three advisory sections and duplication between the inline workflow and the standard_workflow reference, plus a missing post-filter verification checkpoint for the destructive QC step.
Suggestions
Consolidate 'Key Parameters to Adjust', 'Common Pitfalls and Best Practices', and 'Tips for Effective Analysis' into a single section — the multi-resolution clustering and use_raw advice currently appears three times.
Add an explicit post-filter validation checkpoint after the QC step (e.g., re-plot QC metrics or check adata.shape after filter_cells/filter_genes) since filtering destructively drops cells and genes.
Trim the inline 7-step workflow to the essential commands and defer detailed walkthroughs to references/standard_workflow.md, which already covers the same ten steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is code-dominant with terse comments and avoids explaining concepts Claude already knows (no primer on what RNA-seq or UMAP is). It is not 5 because the three overlapping advisory sections — 'Key Parameters to Adjust', 'Common Pitfalls and Best Practices', and 'Tips for Effective Analysis' — repeat each other (multi-resolution clustering advice and the use_raw note each appear two to three times) and could be consolidated. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready code throughout every workflow step, plus concrete CLI invocations with flags ('python scripts/qc_analysis.py input.h5ad --output filtered.h5ad --mt-threshold 5 --min-genes 200 --min-cells 3') and a copy-and-customize template command. Specific examples cover the common cases (10X/h5ad/CSV loading, Leiden clustering, marker identification). | 5 / 5 |
Workflow Clarity | A clearly numbered 1-7 sequence (QC → normalization → dimensionality reduction → clustering → markers → annotation → save) with real checkpoints: QC violin plots before thresholding, the PCA elbow plot ('Check elbow plot'), trying multiple resolutions, and 'Validate biologically: Check marker genes match expected cell types'. It is not 5 because the destructive filtering step (filter_cells/filter_genes/MT% subsetting) lacks an explicit post-filter verification step (e.g., re-checking adata shape or re-plotting after filtering); it is above 3 because validation checkpoints are present throughout, not missing. | 4 / 5 |
Progressive Disclosure | The bundle is well-structured and verified: all referenced files exist (scripts/qc_analysis.py, three references/*.md, assets/analysis_template.py), references are one level deep with no nested pointers, and each is clearly signaled with purpose and when-to-read guidance ('Read this reference when performing a complete analysis from scratch'). It is not 5 because the ~200-line inline standard workflow substantially duplicates references/standard_workflow.md, so the split between overview and detail is imperfect. | 4 / 5 |
Total | 17 / 20 Passed |