Content
68%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 with comprehensive executable examples and properly signaled bundle references. The main weaknesses are duplicated inline command blocks across sections and missing validation checkpoints in the batch/destructive workflows.
Suggestions
Add explicit validation checkpoints to the batch-integration and large-dataset workflows (e.g., verify shapes/keys after ad.concat and assert file integrity after write_h5ad) so workflow_clarity can exceed the validation cap.
De-duplicate the per-section "Common commands" blocks against the Quick Start and the referenced reference files, keeping SKILL.md as an overview and leaving full command catalogs in the references.
Move or contextualize the version/release-date detail ("0.12.16, released 2026-05-18") into a compatibility/versioning note rather than the main Installation prose, to reduce time-sensitivity friction.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The prose is mostly lean and domain-specific, but read/write/subset/concat commands are duplicated across the Quick Start and the per-section "Common commands" blocks, and a time-sensitive release date ("0.12.16 (released 2026-05-18)") sits outside any deprecated/old-patterns section, so it could be tightened rather than fitting the efficient 4 anchor. | 3 / 5 |
Actionability | The body is full of copy-paste-ready, executable code covering creation, reading, writing, subsetting, concatenation, integration, and full multi-step workflows, matching the fully-executable top anchor. | 5 / 5 |
Workflow Clarity | Workflows (single-cell RNA-seq, batch integration, large datasets) are clearly numbered and sequenced, but batch/destructive operations like concatenation and file writing lack explicit validate-then-fix feedback loops, so the validation cap holds this at 3. | 3 / 5 |
Progressive Disclosure | Structure is clear with one-level-deep, well-signaled references (all five references/*.md files exist) and per-section bullet lists of what each covers, but the inline "Common commands" blocks duplicate content that also lives in the referenced files, a minor organization gap keeping it just below the cleanly-split 5 anchor. | 4 / 5 |
Total | 15 / 20 Passed |