Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body offers broad, concrete geospatial guidance but is verbose, contains a few non-executable code examples, and omits validation checkpoints in its workflows. Progressive disclosure is undermined by a monolithic overview and two broken reference links.
Suggestions
Trim or move tutorial-style explanations (CRS basics, vector vs raster) and the repetitive install section into references so the body stays a lean overview.
Fix broken references (coordinate-systems.md, hydrology.md) and replace non-executable code (rasterize_features, placeholder x/y, da.from_rasterio, import gdal) with complete, runnable examples.
Add explicit validation/verification steps to multi-step workflows (e.g., run accuracy assessment in the land-cover classification rather than commenting it out).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~680 lines and explains concepts Claude already knows (CRS basics, vector vs raster) plus a long, repetitive installation section, so it is mostly useful but padded and could be tightened. | 2 / 3 |
Actionability | Many executable code blocks are concrete, but several are incomplete or broken (undefined 'rasterize_features' helper, placeholder 'x, y' ROI, non-existent 'da.from_rasterio', deprecated 'import gdal', and a commented-out accuracy step), matching the incomplete-guidance anchor. | 2 / 3 |
Workflow Clarity | Multi-step workflows like land-cover classification and flood mapping are sequenced but lack validation checkpoints — the classification workflow comments out accuracy assessment and the flood workflow is pure pseudocode, capping clarity at 2. | 2 / 3 |
Progressive Disclosure | Reference files are clearly signaled one level deep, but the SKILL.md body itself is monolithic with much content that could live in references, and two referenced files (coordinate-systems.md, hydrology.md) do not exist in the bundle. | 2 / 3 |
Total | 8 / 12 Passed |