Content
86%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 well-constructed skill body: executable, self-verifying code with version-pinned, migration-aware API guidance, and clean offloading of detail to real, well-described reference files. The only weaknesses are minor token overhead from the citation block and boundary disclaimers, and the absence of an explicit error-recovery loop in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and code-heavy, focused on Zarr-3-specific non-obvious facts ("create_dataset / require_dataset are removed", format-3 default Zstd, "Negative-step slices are unsupported") rather than concepts Claude already knows. Minor trim candidates keep it below 5: the ~15-line citation policy section, several boundary disclaimers ("This does not establish cloud permissions, production throughput..."), and pinned integration versions in prose. | 4 / 5 |
Actionability | All examples are complete, copy-paste executable Python with imports, concrete store paths, and assertions that verify results (roundtrip, fill values, indexing semantics, attribute roundtrip), plus exact install commands. They cover the common cases (create, index, resize/append, groups) exactly as the score-5 anchor requires. | 5 / 5 |
Workflow Clarity | The six-step workflow has an explicit validation step ("Reopen read-only and compare values, dtype, shape, coordinates, units, masks and metadata") and a publish-only-after-validation gate, plus destructive-mode warnings ("'w' destroys existing content"), satisfying the cap for destructive/batch operations. Not 5 because there is no explicit error-recovery feedback loop (no 'if comparison fails, fix and re-verify' branch). | 4 / 5 |
Progressive Disclosure | The SKILL.md is a concise overview with worked core examples, and seven one-level-deep references — all of which exist on disk (api_reference.md, chunking_and_compression.md, integration.md, performance_and_patterns.md, storage_backends.md, v3_migration.md, review.md) — each signaled with a one-line description of its scope. Content is appropriately split with easy navigation, matching the score-5 anchor. | 5 / 5 |
Total | 18 / 20 Passed |