Content
85%Reviews 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 with clear workflows and genuine progressive disclosure to two real reference files. The main weakness is conciseness: the redundant 'Common Use Cases' section and standard-scanpy walkthrough add tokens without adding Census-specific value.
Suggestions
Remove or collapse the 'Common Use Cases' section — Use Cases 1–4 duplicate the Core Workflow Patterns already shown in sections 2, 3, 5, and 8, adding length without new information.
Trim the standard scanpy pipeline in section 7 (normalize_total, log1p, highly_variable_genes, PCA, neighbors, UMAP) to just the Census-loading step, since Claude already knows the scanpy workflow.
Consider moving the full pattern catalog in 'Core Workflow Patterns' into references/common_patterns.md and keeping only a quick-start example inline, to reduce body length while preserving detail in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient Census-specific API detail, but the 'Common Use Cases' section duplicates the Core Workflow Patterns (Use Cases 1–4 re-implement sections 2/3/5/8) and section 7 walks through standard scanpy steps (normalize_total/log1p/PCA/UMAP) Claude already knows. | 2 / 3 |
Actionability | Provides fully executable, import-bearing, copy-paste-ready code throughout (open_soma, get_anndata, axis_query, ExperimentDataset, spatial to_spatialdata), plus concrete filter syntax and commands — matching the executable anchor. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit checkpoints ('Estimate Query Size Before Loading' branches to out-of-core processing; 'Two-Step Workflow: Explore Then Query') and a troubleshooting section for error recovery. | 3 / 3 |
Progressive Disclosure | Body is an overview that pushes detail to two real, one-level-deep bundle files (references/census_schema.md, references/common_patterns.md), each clearly signaled with a 'When to read' clause for easy navigation. | 3 / 3 |
Total | 11 / 12 Passed |