Content
72%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 commands and a solid connection state-machine, but it loses workflow-clarity points for missing verification on destructive action/proxy flows and loses progressive-disclosure points for inlining a large reference table with no external file structure.
Suggestions
Add a verification checkpoint after destructive/batch actions, e.g. "After delete-campaign or send-transactional-email, re-run get-campaign / get-transactional-campaign to confirm the result before reporting success."
Move the 20-row Popular actions table into a separate ACTIONS.md and summarize the categories inline so SKILL.md stays an overview pointing one level deep.
Trim the opening "CampaignHQ is a software platform..." paragraph and the auth-plumbing editorializing; Claude can infer the product context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean executable commands, state tables, and a proxy-options table that earn their tokens, with only minor padding such as the opening product-description paragraph and editorializing like "so you can focus on the integration logic rather than auth plumbing." Matches the efficient-with-minor-trim anchor; not a 5 because those few explanatory sentences are removable. | 4 / 5 |
Actionability | Copy-paste-ready commands cover the common cases end to end: install, login, connection ensure/get with --wait, action list/run with --input, proxy with a full flags table, plus a 20-row popular-actions table of real action keys. Matches the fully-executable anchor; placeholders like <actionId> are clearly marked. | 5 / 5 |
Workflow Clarity | Connection setup has a clear state-driven sequence with checkpoints (ensure -> poll --wait -> branch on READY/CLIENT_ACTION_REQUIRED -> re-poll), but the action-run and proxy flows include destructive/batch operations (delete-campaign, send-transactional-email) with no verification step, so the destructive-operation cap holds. Not a 4 because that validation gap is explicit in the guidelines. | 3 / 5 |
Progressive Disclosure | Headers organize the single self-contained file well, but there are no external references at all and the 20-row popular-actions table is inline reference material that could live in a separate file. Matches the some-structure / content-that-should-be-separate-is-inline anchor; not a 4 because there is no reference signaling or file split, and not a 2 because section structure is genuinely present. | 3 / 5 |
Total | 15 / 20 Passed |