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 content is highly actionable, with copy-paste-ready CLI commands covering install, auth, connection setup, action discovery/execution, and a proxy fallback. Its weaknesses are structural: a monolithic layout with an inlined bulk actions table, a workflow that references a nonexistent 'Step 2', and no validation guidance for destructive operations like delete-campaign or sending emails.
Suggestions
Move the 'Popular actions' table (and possibly the connection-state details) into a references/ file, keeping SKILL.md as a lean overview with clearly signaled links.
Fix the broken step numbering — replace 'skip to Step 2' and the orphaned '1b' heading with a coherent numbered sequence.
Add validation/confirmation guidance for destructive or batch operations (e.g., verify a campaign's status or confirm with the user before delete-campaign and send-transactional-email).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, executable commands and tables, with only minor over-explanation such as the opening paragraph describing what CampaignHQ is ("CampaignHQ is a software platform used by political campaigns...") and flourishes like "so you can focus on the integration logic rather than auth plumbing". This fits anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: concrete install ("npm install -g @membranehq/cli@latest"), auth ("membrane login --tenant --clientName=<agentType>"), connection ("membrane connection ensure \"https://campaignhq.co/\" --json"), action execution with JSON input ("membrane action run <actionId> --connectionId=CONNECTION_ID --input '{\"key\": \"value\"}'"), and a flag table for proxy requests. Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The connection setup has a clear sequence with state-based checkpoints and a poll-again feedback loop ("poll again with membrane connection get <id> --json to check if the state moved to READY"), but the flow is broken by references to a nonexistent 'Step 2' ("If the returned connection has state: READY, skip to Step 2") and there is a '1b' heading with no '1a'. More importantly, destructive and send operations (delete-campaign, send-transactional-email) are listed with no validation or confirmation steps, which caps workflow clarity at 3 per the batch/destructive feedback-loop rule. | 3 / 5 |
Progressive Disclosure | The document has good section structure but is a single monolithic file with a 20-row actions table inlined that functions as bulk API reference material ("## Popular actions" table) — content that belongs in a separate reference file per anchor 3 ('content that should be separate is inline'). It is not anchor 2 because sections are well-organized and commands are clearly presented, and not anchor 4 because there are no external reference files at all to offload detail. | 3 / 5 |
Total | 15 / 20 Passed |