Content
68%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 highly actionable with concrete, copy-paste CLI commands and a well-organized structure, but it spends tokens explaining SurveyMonkey itself and, critically, offers no validation guidance for its destructive and batch operations. Tightening the intro and adding verification steps would lift its weakest dimensions.
Suggestions
Remove the SurveyMonkey definition intro (lines 17) and the "so you can focus on the integration logic rather than auth plumbing" padding to respect the token budget.
Add a verification step for destructive and batch actions, e.g. confirm the target id via a get/list call before running delete-survey or create-contacts-bulk, and check the response for success/failure counts afterward.
Fix the dangling "skip to Step 2" references (lines 70, 84) by labeling the next section as Step 2 or rewording to "skip to Searching for actions."
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body opens by explaining what SurveyMonkey is ("an online survey development cloud-based software... used by businesses of all sizes"), which Claude already knows, and includes mild fluff like "so you can focus on the integration logic rather than auth plumbing." The rest is mostly lean commands, so it fits anchor 3 (mostly efficient but some unnecessary explanation) rather than 4. | 3 / 5 |
Actionability | It provides copy-paste-ready CLI commands with flags and a JSON-parameter example, covering install, auth, connection, action search, action run, and proxy requests. This matches anchor 5 (fully executable; copy-paste ready; specific examples cover common cases). | 5 / 5 |
Workflow Clarity | The connection flow is sequenced with polling and state-based feedback loops (READY/BUILDING/CLIENT_ACTION_REQUIRED), but the skill exposes destructive actions (delete-survey, delete-webhook) and batch actions (create-contacts-bulk, get-responses-bulk) with no validation or verification steps, which per the rubric caps workflow clarity at 3. A dangling "skip to Step 2" reference (no Step 2 exists) further weakens the sequence. | 3 / 5 |
Progressive Disclosure | No bundle files exist, and the single SKILL.md is organized into clear sections (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices). The 20-row actions table is bulk that could live in a reference, but inlining it is reasonable for a CLI-wrapping skill, matching anchor 4 (good structure; minor organization gaps) rather than 5's explicit one-level-deep references. | 4 / 5 |
Total | 15 / 20 Passed |