Content
65%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 content is highly actionable with executable CLI commands and a well-sequenced connection workflow including state feedback loops. Its main gaps are the absence of validation guidance around destructive actions (capping workflow clarity) and no progressive disclosure via separate reference files.
Suggestions
Add an explicit validation/confirmation checkpoint before destructive actions like 'Delete Account' (e.g. verify the target ID and confirm with the user before running delete-* actions).
Move the Popular actions catalog and proxy flag reference into a separate reference file and link to it from the body to improve progressive disclosure.
Trim the introductory paragraph and 'auth plumbing' prose that explain context Claude can already infer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with executable commands and brief prose, but includes unnecessary padding such as the opening 'Badger Maps is a route optimization and CRM app... Field sales reps and teams use it to improve efficiency and close more deals' and 'so you can focus on the integration logic rather than auth plumbing'. Not a 4 because several sentences explain context Claude could infer; not a 2 because the bulk is lean command reference. | 3 / 5 |
Actionability | Provides copy-paste-ready, executable commands for every phase (install, login, connection ensure, action list/run, request proxy) with flag tables covering common cases. Not below 5 because the examples are concrete and complete for the typical workflow; placeholders like CONNECTION_ID are standard and clearly marked. | 5 / 5 |
Workflow Clarity | The connection flow is well sequenced with state-based checkpoints and a feedback loop (poll again after CLIENT_ACTION_REQUIRED), but the skill exposes destructive operations ('Delete Account') with no validation/verification step before running. Per the destructive-operations cap, this limits the score to 3; it cannot rise to 4 without a confirm/verify checkpoint around destructive actions. | 3 / 5 |
Progressive Disclosure | The body is organized into clear sections, but no bundle files exist and no external references are signaled; content that could live in a separate file (the Popular actions table, proxy flag reference) is inlined. Not a 2 because section structure is reasonable; not a 4 because there are no one-level-deep references and the action catalog is inline. | 3 / 5 |
Total | 14 / 20 Passed |