Content
67%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 solid, mostly executable CLI integration guide with a well-validated connection workflow and clean section structure. Its main weaknesses are residual marketing prose, an inconsistent CLI invocation convention, and absent verification guidance for the action/proxy steps.
Suggestions
Delete the marketing intro sentence ("It's used by marketing teams...improve ROI") and trim phrases like "so you can focus on the integration logic rather than auth plumbing".
Standardize on one invocation form (either bare `membrane` or `npx @membranehq/cli@latest`) throughout, or state once that they are interchangeable.
Add a brief verification/inspection step after running actions or proxy requests (e.g., check the `output`/status fields and handle non-2xx responses) to close the workflow loop on potentially destructive calls.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command-driven and lean, but retains marketing-style padding ("It's used by marketing teams and advertising agencies to streamline their workflow, track performance, and improve ROI") and phrases like "so you can focus on the integration logic rather than auth plumbing" that Claude does not need. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready commands for install, auth, connect, search, run, and proxy with a flags table, but invocation is inconsistent ("membrane" vs "npx @membranehq/cli@latest") and the action-run examples rely on unpopulated placeholders. | 4 / 5 |
Workflow Clarity | The connection setup is a clearly sequenced flow with explicit validation checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED states) and polling feedback loops for error recovery, though the referenced "Step 2" is never labeled and the action/proxy sections lack verification steps. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content lives in a single well-sectioned SKILL.md with clear headers and no nested references; it is over 50 lines with some redundancy ("Popular actions" overlaps "Searching for actions") keeping it out of the top band. | 4 / 5 |
Total | 15 / 20 Passed |