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 content is a strong, actionable CLI integration guide with a clear connection workflow and feedback loops, but it is weakened by marketing padding, missing validation for destructive data operations, and a monolithic structure with no progressive disclosure to separate reference files.
Suggestions
Remove the marketing/background opening paragraph and filler lines so the body assumes Claude's competence and starts with the integration workflow.
Add validation/verification steps around action runs and proxy mutating requests (e.g. inspect outputSchema before running, verify the output field, dry-run or confirm before batch/DELETE).
Move the resource overview list and the proxy flag reference table into separate reference files and link to them from SKILL.md to enable progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient CLI guidance, but the opening marketing paragraph ("MParticle is a customer data platform... used by marketing, product, and engineering teams to improve customer experiences and drive growth") is background padding Claude does not need, plus filler like "Use action names and parameters as needed." | 3 / 5 |
Actionability | Concrete executable commands throughout (install, login, connection ensure, action list/run, proxy with a full flag table), but minor gaps remain: inconsistent `membrane` vs `npx @membranehq/cli` invocation, a repeated `action list` command, and placeholders like CONNECTION_ID never shown in a worked example. | 4 / 5 |
Workflow Clarity | The install→auth→connect→search→run sequence is clear with good feedback loops for the connection state machine, but the core data-manipulation steps (running actions, proxying POST/PUT/PATCH/DELETE) include no validation or verification; per the destructive/batch cap this cannot exceed 3. | 3 / 5 |
Progressive Disclosure | No bundle files exist and the ~150-line body is entirely inline; it is well-sectioned, but reference-like content (the resource overview list, full connection state-machine, proxy flag table) is inlined rather than split into separate files, and no external references are signaled. | 3 / 5 |
Total | 13 / 20 Passed |