Content
67%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 a well-structured, actionable CLI integration guide with real validation feedback loops for connection setup. Its main weaknesses are marketing-fluff padding in the intro and a couple of broken step-numbering references that muddy the workflow sequence.
Suggestions
Cut the introductory marketing paragraph ("used by enterprises looking to streamline workflows") and the auth-plumbing aside; lead with what Claude must do.
Fix the workflow numbering: add a "1a"/"Step 1" label and define the referenced "Step 2" so the skip instruction resolves.
Tighten "Use action names and parameters as needed." into a concrete instruction pointing to the action search command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command-driven and efficient, but phrases like "It's used by enterprises looking to streamline workflows" and "so you can focus on the integration logic rather than auth plumbing" are unnecessary marketing/explanatory padding Claude does not need, matching the mostly-efficient-but-could-be-tightened anchor. | 3 / 5 |
Actionability | Concrete copy-paste commands like `membrane connection ensure "https://www.psigen.com/" --json` and `membrane action run <actionId> --connectionId=CONNECTION_ID --input '{...}' --json` cover the common cases, with only minor gaps (e.g. the vague "Use action names and parameters as needed."). | 4 / 5 |
Workflow Clarity | The connect-and-poll flow has real validation checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR states with retry polling), but the sequence references an unlabeled "Step 2" and a "1b" with no "1a", leaving minor sequencing gaps that keep it below score 5. | 4 / 5 |
Progressive Disclosure | The body is well sectioned into Install, Auth, Connecting, Searching, Running, Proxy, and Best practices with content appropriately inline for a CLI integration guide, and the only external pointer is the official docs URL; good structure with minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |