Content
75%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 commands and a clear connection/workflow sequence, and it is well-structured into navigable sections. Its main weaknesses are trimmable marketing-style prose and a missing error-recovery feedback loop for action execution.
Suggestions
Cut the descriptive opener ("Reverse Contact helps sales teams identify decision-makers...") and the "so you can focus on..." / "burn less tokens" asides to tighten token efficiency.
Add an explicit validate/retry feedback loop after `membrane action run` (check the `output` field for errors, re-fetch connection state, retry on transient failure).
Merge the near-duplicate "Searching for actions" and "Popular actions" command examples to remove redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is lean command reference, but prose padding (the sales-team opener, "so you can focus on the integration logic rather than auth plumbing", "This will burn less tokens and make communication more secure") goes beyond minor trimmable instances. | 3 / 5 |
Actionability | Copy-paste-ready commands are given throughout (npm install, membrane login, connection ensure, action list/run, request) with a complete proxy-flag table and clear placeholders, covering the common cases. | 5 / 5 |
Workflow Clarity | The install → auth → connect → poll → search → run sequence is clear with explicit state checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and polling, though the action-run and proxy steps lack explicit result/error feedback loops. | 4 / 5 |
Progressive Disclosure | Well-organized into clear section headers with no external references needed and no nesting, but it is a single ~140-line file (above the 50-line simple-skill carve-out) with minor redundancy between the "Searching for actions" and "Popular actions" sections. | 4 / 5 |
Total | 16 / 20 Passed |