Content
65%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable reference skill packed with executable code and a well-signaled reference index, but it is held back by redundant inline examples that duplicate bundle files, missing validation checkpoints on write operations, and one orphaned reference file.
Suggestions
De-duplicate NDVI: keep one canonical example in the body and point to references/code-examples.md for the others, removing the triplication across Quick Start, Spectral Indices, and STAC sections.
Add explicit validate→fix→retry feedback loops around destructive/batch writes (e.g. after cog_validate fails, loop back to fix and re-run; verify classified raster output before returning).
Link the orphaned references/specialized-topics.md from the Detailed Documentation section, or move its content into an already-linked file so every bundle file is discoverable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Prose is lean and assumes competence (no 'what is a CRS' explanations), but NDVI is computed in three separate sections and the inline Core Concepts CRS content duplicates references/coordinate-systems.md, so not every token earns its place. | 2 / 3 |
Actionability | Nearly every section ships complete, executable, copy-paste-ready code — NDVI via rasterio, GeoPandas spatial joins, Earth Engine time series, STAC/Planetary Computer, COG reads/writes — matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | Sections are clearly labeled and Best Practices are numbered, but the batch/destructive write operations (image classification output, COG write) lack explicit validate→fix→retry checkpoints, which caps clarity at 2 per the rubric. | 2 / 3 |
Progressive Disclosure | The 'Detailed Documentation' section cleanly signals 13 one-level-deep references with descriptions, but one bundle file (specialized-topics.md) is never linked, and substantial inline content (CRS concepts, many code examples) overlaps the reference files, leaving content that could be separate inline. | 2 / 3 |
Total | 9 / 12 Passed |