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 delivers strong, copy-paste-ready CLI guidance with an unusually good connection-state feedback loop, and it correctly avoids teaching things Claude already knows. Its main weaknesses are the noise in the actions table, a broken 'Step 2' cross-reference, and the absence of any validation guidance for the destructive/batch actions it advertises.
Suggestions
Add a validation checkpoint before destructive/batch actions, e.g. 'Before delete-list or batch-delete-subscribers, run get-subscribers/get-list-stats to confirm the target and confirm with the user' — this would lift the workflow-clarity cap.
Fix the dangling 'Step 2' references by labeling the workflow steps explicitly (Step 1: connect, Step 2: search/run actions) or removing the cross-references.
Replace the 'No description' column with one-line descriptions or drop it entirely, and add one worked example (e.g., add-subscriber with a real --input payload).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — Membrane-specific commands and state semantics are things Claude does not already know and are explained tersely. But the 19-row 'Popular actions' table repeats 'No description' in every row, 'Use action names and parameters as needed.' is a vacuous sentence, and the 'Agent Types' paragraph trails off with 'etc.', so it 'includes some unnecessary explanation or could be tightened' rather than being minor-trim level 4. | 3 / 5 |
Actionability | Commands are concrete and executable throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://acumbamail.com" --json', 'membrane action run <actionId> --connectionId=... --input {...}', plus a complete proxy flag table. It is not level 5 because there is no worked end-to-end example with real parameter values (e.g., an add-subscriber call with an actual email payload) and the jump from 'action list' output to an actionId is left implicit. | 4 / 5 |
Workflow Clarity | The install → login → connection ensure → poll state → search → run sequence is present with real feedback loops (long-poll while BUILDING, re-poll after CLIENT_ACTION_REQUIRED, inspect error on CONFIGURATION_ERROR). But the 'skip to **Step 2**' cross-references point to a heading that does not exist (there is no Step 1/Step 2 labeling), and the skill exposes destructive and batch operations (delete-list, batch-delete-subscribers) with no validation or confirmation guidance — the rubric's cap for missing validation in destructive/batch workflows holds this at 3. | 3 / 5 |
Progressive Disclosure | There is no bundle (references/, scripts/, assets/ are absent), so all ~175 lines live in a single SKILL.md with reasonable headers. The action catalog table and proxy flag reference material are inlined rather than split into a reference file, matching 'Some structure but could be better organized; content that should be separate is inline'. It is not level 4 because the reference material sits inline without any external split; it is not level 2 because headers and navigation are clear and there is no buried-reference problem. | 3 / 5 |
Total | 13 / 20 Passed |