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 a solid operational guide: nearly every section gives copy-pasteable Membrane commands, and connection lifecycle states are handled with concrete next-step guidance. Its main weaknesses are an incoherent 'skip to Step 2' cross-reference, no validation/confirmation guidance for destructive actions like delete-topic, a bulk actions table inlined rather than split into a reference file, and a few padded passages.
Suggestions
Fix the dangling cross-reference: the text says 'skip to **Step 2**' but no Step 2 section exists — either number the workflow steps consistently or replace the reference with the actual section name.
Add explicit verification guidance for destructive operations, e.g. confirm with the user before running delete-topic, and verify topic state after update-topic/publish-project before reporting success.
Move the 19-row actions table into a references/ file (e.g. references/actions.md) and keep only the most common actions inline; also trim filler lines like 'Use action names and parameters as needed.' and resolve the npx-vs-installed-CLI inconsistency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable commands, but several passages are padding: a two-sentence intro on who uses ClickHelp, the vacuous line 'Use action names and parameters as needed.', 'This is the fastest way to get a connection.', and a sloppy agent-types note ('Those will be used to adjust tooling to be used best with your harness'). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); it is above 2 because unnecessary prose is the exception, not the rule, and below 4 because there are multiple trimmable passages. | 3 / 5 |
Actionability | Commands are concrete and executable throughout: 'npm install -g @membranehq/cli@latest', 'membrane login complete <code>', 'membrane connection ensure "https://clickhelp.com/" --json', full connection-state handling, and a proxy flag table. It falls short of anchor 5 only in minor gaps: the parameter example is generic ('--input '{"key": "value"}'' rather than a real payload for a listed action) and the body mixes the installed CLI with 'npx @membranehq/cli'. | 4 / 5 |
Workflow Clarity | The setup sequence (install → login → connect → poll state → search → run → proxy) is clear and includes state-based checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), but 'If the returned connection has state: "READY", skip to **Step 2**' references a section that does not exist, and destructive operations prominently listed in the actions table (delete-topic, update-topic) carry no validation or confirmation guidance — the rubric's cap for destructive/batch operations without verification applies. It is above anchor 2 because the sequence and state handling are well defined, and at 3 rather than 4 because of the dangling step reference and missing destructive-op checkpoints. | 3 / 5 |
Progressive Disclosure | The body has good section headers but no bundle files exist and the 19-row 'Popular actions' table is bulk API-reference content inlined in a ~165-line SKILL.md — clearly matching anchor 3 ('content that should be separate is inline'). It is above 2 because the document is well structured and navigable, and below 4 because the action catalog and proxy reference material would be better split into a referenced file, especially given the 50-line simple-skill threshold is exceeded. | 3 / 5 |
Total | 13 / 20 Passed |