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-engineered skill body: fully executable examples that match the bundled script, a validated workflow with explicit checkpoints, and exemplary one-level-deep progressive disclosure across 15 verifiable reference files. The only weaknesses are minor: some trimmable boilerplate (citation block, version pins) and the absence of explicit error-recovery loops after the raised failures.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and gotcha-focused, assuming Claude's competence ('Tiling/compression alone does not establish COG layout', 'matching array shape alone does not prove alignment', 'Cloud filters at scene level do not replace per-pixel masks') with no re-explanation of known concepts. It is 4 rather than 5 because of minor trimmable material: the verbatim citation block, three separate uv pip install lines, and pinned version strings ('GeoPandas 1.2.0, Rasterio 1.5.2...') that add time-sensitive detail, though these are at least quarantined in a dedicated 'Tested scope and installation' section. | 4 / 5 |
Actionability | Every section ships complete, executable code: the raster recipes call bundled functions whose signatures (write_ndvi, terrain_metrics, classify_imagery) match scripts/raster_workflows.py exactly, and the vector, STAC, OSMnx, and COG snippets are copy-paste ready with real arguments and inline error handling ('if not items: raise ValueError', 'if not valid: raise ValueError(errors)'). The body explicitly flags file-dependent examples as templates, covering the common cases honestly. | 5 / 5 |
Workflow Clarity | The numbered 6-step workflow has explicit verification checkpoints ('Verify CRS from authoritative metadata. ... Never infer an unknown CRS from plausible bounds', 'Check numeric expectations on a small known fixture before scaling up') and the code raises on failure (missing CRS, no scenes, invalid COG). It falls short of 5 because there is no fix-and-retry feedback loop: failures are raised but no recovery guidance follows, leaving the loop implicit. | 4 / 5 |
Progressive Disclosure | The body is an overview with quick-start recipes inline and all deeper material split across 15 real, one-level-deep reference files, each listed with a one-line descriptor in the References section and contextually linked where relevant (machine-learning.md in the classification section, data-sources.md and remote-sensing.md in the catalogs section). The bundled script's import requirements are documented and all referenced paths verified to exist. | 5 / 5 |
Total | 18 / 20 Passed |