Content
75%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-structured decision-framework skill: lean, expert-voiced, with a clear 18-step working pattern, embedded validation checkpoints, an output checklist, and one-level-deep references that mostly exist in the bundle. The main weaknesses are unreachable shared-theory reference paths and enumerations in the Working Pattern that duplicate detail already delegated to reference files.
Suggestions
Fix or inline the five `../../references/foundations/*` paths — none resolve in the bundle as shipped; either ship those files, convert to a resolvable path, or drop the shared-theory section.
Tighten the long enumerations in Working Pattern steps 13 and 9 — the per-tool capability lists duplicate what `deckgl-d3-geo-stack-selection.md` and `slippy-map-and-product-stack-selection.md` already cover; a one-line pointer per concern would cut tokens without losing guidance.
Add an explicit validate-and-fix loop for the coordinate-alignment audit (step 12), e.g. 'if spot checks fail, re-check CRS and longitude origin before continuing' — this would raise workflow clarity to anchor 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence throughout — it never explains what a map, projection, or library is — and every step is decision guidance rather than padding (e.g. "screen-stable strokes for borders, outlines, and graticules unless changing thickness is itself meaningful"). It is not level 5 because the long enumerations in step 13 ("D3 geo for custom projections, thematic cartography, and annotation-rich analytical maps" and eight more) and step 9 restate tool capabilities in near-prose that could be tightened or delegated to the stack-selection references. | 4 / 5 |
Actionability | As an instruction-only skill it has no code, which the scoring notes say not to penalize when guidance is actionable — and it is: concrete decision rules like "audit coordinate alignment across basemap/texture, event markers, labels, hit testing, camera focus, and fallback geometry before coding. Record longitude origin, wrap policy, and at least a few known-place spot checks" and situation-specific overlap strategies ("exact-location anchor dots when large proportional... point symbols must preserve the true coordinate"). Not level 5 because the common implementation cases (e.g. an actual choropleth recipe) are delegated to references rather than shown, leaving minor gaps in copy-paste-ready guidance. | 4 / 5 |
Workflow Clarity | The 18 steps form a coherent sequence from the map-or-not decision through purpose, basemap, map family, overlap, zoom, projection, and finally stack choice, with an Output Expectations checklist. Validation checkpoints are present (step 12's pre-coding "audit coordinate alignment... before coding" and step 17's "verify the interaction with mouse wheel, trackpad, touch pan, and pinch") but there are no explicit feedback loops (validate → fix → retry), which keeps it at the 'most checkpoints present, minor validation gaps' anchor rather than 5. | 4 / 5 |
Progressive Disclosure | Structure is good: an overview body, a References section split into shared theory and skill references, and all 9 skill-local reference files (e.g. `./references/map-or-not.md`, `./references/projections-and-normalization.md`) exist and match their cited paths one level deep. It falls short of the anchor-5 'well-signaled, easy navigation' pattern because the 5 shared-theory paths (e.g. `../../references/foundations/mobile-first-responsive-visualization.md`) do not resolve anywhere in the provided bundle — more than a third of the cited references are unreachable as written. | 4 / 5 |
Total | 16 / 20 Passed |