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 body is a solid, executable guide: real commands, a well-documented connection state machine, and a useful proxy fallback with a flags table. Its weaknesses are padding (hollow entity overview, redundant action-list instructions), a "Popular actions" section that contains no popular actions, and a dangling "Step 2" cross-reference that breaks the workflow's internal navigation.
Suggestions
Delete the contentless "A/B Tasty Overview" entity list and the vague "Agent Types" paragraph, or fold a one-line entity glossary into the intro — they spend tokens without teaching anything.
Fix the dangling "skip to **Step 2**" reference by numbering the actual steps (1. Connect, 2. Discover actions, 3. Run or proxy), and make the "1b" heading consistent with that numbering.
Either populate "Popular actions" with a short list of common A/B Tasty actions (e.g. list campaigns, get test results, manage variations) or merge it with "Searching for actions" to remove the duplicated discovery command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient commands and examples, but several sections add little: the hollow "A/B Tasty Overview" bullet list (Campaign/Variation/Account/User/Test with no explanation), the padded "Agent Types" sentence ("claude, openclaw, codex, warp, windsurf, etc. Those will be used to adjust tooling..."), and the "Popular actions" section that repeats the action-discovery command already shown under "Searching for actions" without listing any actual actions. | 3 / 5 |
Actionability | Concrete, executable bash commands throughout — install (`npm install -g @membranehq/cli@latest`), login, `connection ensure`, polling with `--wait`, `action list --intent`, `action run ... --input '{...}'`, and a proxy flags table — with placeholders clearly marked (CONNECTION_ID). Falls short of anchor 5 because "Popular actions" lists no real example actions and the `clientAction.agentInstructions` handling is described but never demonstrated. | 4 / 5 |
Workflow Clarity | A clear install → login → connection ensure → poll state → handle clientAction → search actions → run/proxy sequence with good checkpoints: the READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR state machine tells the agent exactly what to do in each case, including re-polling after user auth. Minor gaps keep it from 5: the instruction "skip to **Step 2**" references a step that is never labeled, the "1b" heading has no "1a"/numbered structure, and CLI invocation is inconsistent (`npx @membranehq/cli` vs `membrane`). | 4 / 5 |
Progressive Disclosure | With no bundle files, everything is inline in a single ~140-line SKILL.md with clear section headers (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) — appropriate for this size. Minor organization gaps: the contentless Overview entity list and the mislabeled "Popular actions" section, and the proxy flags table is borderline reference material. | 4 / 5 |
Total | 15 / 20 Passed |