Content
57%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 strong on executable CLI commands and covers the full lifecycle from installation through action execution and raw API proxying, with useful connection-state handling. Its main weaknesses are organizational: dangling "Step 2" references reveal an incomplete workflow structure, two sections duplicate the same discovery command, and reference-grade detail (state machine, proxy options) is inlined in a long single file.
Suggestions
Fix the dangling "Step 2" references by numbering the actual workflow steps (1. Install, 2. Authenticate, 3. Connect, 4. Discover actions, 5. Run or proxy), or remove the step labels entirely.
Add one concrete worked example, e.g. `membrane action run <real-action-id> --connectionId=... --input '{"query": "..."}' --json`, and correct `membrane login --tenant` to show the expected value.
Move the connection clientAction state-machine detail and the proxy flag table into a separate reference file (e.g. references/connection-states.md) and keep SKILL.md as a lean overview, merging the duplicate "Searching for actions" / "Popular actions" sections.
Trim filler text: drop "Use action names and parameters as needed.", tighten the "Agent Types" note, and remove the marketing sentence about the connection method being fastest.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command-focused and efficient, but includes several instances of unnecessary or padded text: the marketing-style paragraph "This is the fastest way to get a connection..." ("This is the fastest way..."), the rambling "Agent Types" note with "etc." and "Those will be used to adjust tooling to be used best with your harness", the filler line "Use action names and parameters as needed.", and a duplicated `action list` command in both "Searching for actions" and "Popular actions". This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") more than anchor 4, where such instances would be minor. | 3 / 5 |
Actionability | The guidance is largely copy-paste ready: `npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://www.code42.com/" --json`, `membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json`, and a complete proxy flag table cover install, auth, connect, discover, run, and raw-request cases. It falls short of anchor 5 because `membrane login --tenant --clientName=<agentType>` is not executable as written (`--tenant` shows no value) and there is no concrete worked example with a real action id and input payload. It is clearly above anchor 3, which expects pseudocode or missing key details. | 4 / 5 |
Workflow Clarity | A rough sequence exists (install → login → connection ensure → poll until READY → search actions → run actions → proxy fallback) and the connection state machine includes a poll-again feedback loop for CLIENT_ACTION_REQUIRED and explicit error-state handling. However, the text repeatedly says "skip to **Step 2**" while no Step 2 (or Step 1a) heading exists — the sections after the connection steps are unlabeled relative to those references — and there is no explicit ordered overview of the end-to-end workflow. This matches anchor 3 ("steps listed but validation gaps; sequence present but checkpoints missing or implicit"); the dangling step references keep it below anchor 4's "clear sequence". | 3 / 5 |
Progressive Disclosure | The single-file body has reasonable section headers, but it is ~145 lines with no bundle files, and moderately deep reference-style content is inlined — the full connection clientAction state-machine breakdown and the proxy flag table are detail that could live in separate reference files with the main file pointing to them. This fits anchor 3 ("some structure but could be better organized... content that should be separate is inline"); the sectioning is better than anchor 2's minimal structure, but the inlined depth and duplicated/overlapping sections ("Searching for actions" vs "Popular actions") keep it below anchor 4. | 3 / 5 |
Total | 13 / 20 Passed |