Content
92%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.
The body is a lean, expert-level overview with strong progressive disclosure, explicit validation checkpoints, and copy-paste CLI commands. The main gap is that several core-API sections convey rules as prose rather than runnable examples, which keeps actionability just below the top band.
Suggestions
Add small executable code snippets to the prose-only core-API sections (e.g., a minimal sjoin/overlay example with predicate and an audit of unmatched rows) to push actionability to 5.
Consider moving the full pinned dependency snapshot into a short referenced file while keeping a one-line summary inline, to further tighten the reproducible-environment section.
Cross-link the bundled CLI table entries to the relevant correctness gates so the validation workflow maps directly to the tool that performs each check.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence, with no padding explaining what GeoPandas or basic GIS concepts are; every section earns its place, and the pinned versions/dates serve reproducibility rather than filler, matching the lean-and-efficient anchor. | 5 / 5 |
Actionability | Provides copy-paste-ready bash commands for every bundled CLI, a pinned `uv pip install` block, and an executable CRS python snippet, but several core-API sections (data structures, joins, I/O) are decision rules in prose without accompanying runnable code, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The 8-step numbered "Correctness gates" and the "Output contract" (use a new path, reopen the artifact, compare counts/types) form an explicit sequenced checklist with validation checkpoints and feedback loops (validate before/after repair), matching the top anchor. | 5 / 5 |
Progressive Disclosure | SKILL.md is a concise overview with six well-signaled one-level-deep references ("See [CRS management](references/crs-management.md)" etc.), a bundled-CLI table with purposes, and a reference index; the referenced files are real and content is appropriately split, matching the clear-overview anchor. | 5 / 5 |
Total | 19 / 20 Passed |