Content
76%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 executable CLI commands and a clean structure, but lacks validation checkpoints for batch/broadcast operations and could offload some reference material to bundle files.
Suggestions
Add a validation checkpoint before running broadcast/send actions, e.g. "Confirm the recipient list and message before running send/broadcast actions; verify the connection with `connection list` first."
Trim the opening product framing paragraph and merge the redundant "Popular actions" section into the searching-actions section.
Move the proxy flag reference table to a references/ file and link to it, keeping only the most common flags inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and command-driven, with only minor trimmable padding such as the product framing paragraph, "focus on the integration logic rather than auth plumbing", and the redundant "Popular actions" restatement. | 4 / 5 |
Actionability | Copy-paste-ready `npx @membranehq/cli@latest` commands cover setup, connect, list, search, run, and proxy, with a full flag table and clearly signaled placeholders. | 5 / 5 |
Workflow Clarity | A clear sequence (setup → connect → discover → run → proxy) is present, but there are no validation/verification checkpoints and Broadcasts are inherently batch operations, so the destructive/batch cap at 3 applies. | 3 / 5 |
Progressive Disclosure | Content is well-organized into clear headed sections with no nested references, but at ~110 lines with no external bundle files, parts like the proxy flag table could be split out, fitting anchor 4 over the simple-skill 5 exception. | 4 / 5 |
Total | 16 / 20 Passed |