Content
61%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 strong, executable reference with concrete Membrane CLI commands and a useful actions table, sequenced through connection setup with state polling. Its main gaps are an unnecessary product primer, and the absence of validation/confirmation checkpoints around the destructive delete actions it advertises.
Suggestions
Trim the opening paragraph that defines ArcGIS Online (Claude already knows this) and remove the 'Think of it as Google Maps' analogy.
Add an explicit validation/confirmation step before destructive actions (e.g., 'Before running delete-item or delete-group, confirm the target ID with the user and consider a get-* call first').
Provide one worked end-to-end example (e.g., connect → search-items → get-item → delete-item with confirmation) to turn the scattered commands into a single executable narrative.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is efficient command examples, but the intro ('ArcGIS Online is a cloud-based mapping and analysis platform... Think of it as Google Maps but for professional use') over-explains what the product is, and the sparse Overview tree adds little, fitting 'mostly efficient but includes some unnecessary explanation' rather than 4. | 3 / 5 |
Actionability | Concrete, copy-paste-ready commands with flags cover the common cases (install, login, connection ensure, action list/run, request proxy) plus a full popular-actions table, but placeholders like CONNECTION_ID and the lack of a worked end-to-end example leave minor gaps versus the 5 anchor. | 4 / 5 |
Workflow Clarity | The connection workflow is well-sequenced with state polling (READY/BUILDING/CLIENT_ACTION_REQUIRED), but the skill lists destructive actions (Delete Item, Delete Group) with no pre-run validation or confirmation checkpoint, so per the destructive-operation cap it cannot exceed 3. | 3 / 5 |
Progressive Disclosure | The single SKILL.md is organized into clear, well-labeled sections (Install, Authentication, Connecting, Searching, Popular actions, Proxy, Best practices) with no deep nesting; at ~150 lines it is over the simple-skill threshold, so it lands at 'good structure; minor organization gaps' rather than 5. | 4 / 5 |
Total | 14 / 20 Passed |