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, command-driven guide: nearly every section gives runnable Membrane CLI commands, and the connection workflow includes real validation via polling and state-based error handling. Its main flaws are padding (the ACF definition paragraph and Membrane promotional asides), a broken step numbering ('skip to Step 2' with no Step 2, a '1b' with no '1a'), and inconsistent CLI invocation between 'membrane' and 'npx @membranehq/cli'.
Suggestions
Delete or compress the opening paragraph explaining what ACF is and trim the Membrane endorsements ('handles authentication... so you can focus', 'will burn less tokens') to bare factual statements.
Fix the workflow numbering: label the sections as explicit Steps 1–3 (connect, wait for READY, discover/run actions) so 'skip to Step 2' and the '1b' subsection resolve to real anchors.
Standardize on one CLI invocation ('membrane' vs 'npx @membranehq/cli') and show one worked example that extracts the connection id from the 'connection ensure --json' output and uses it in 'action list'/'action run'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but includes unnecessary explanation: 'ACF is a WordPress plugin that allows developers to add custom fields...' explains a concept Claude already knows, and lines like 'Membrane handles authentication and credentials refresh automatically — so you can focus on the integration logic rather than auth plumbing' and 'This will burn less tokens and make communication more secure' are endorsement padding. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened' — not 4, because there are several (not just minor) instances of padding; not 2, because the bulk is concrete command documentation rather than verbose tutorial prose. | 3 / 5 |
Actionability | The content supplies executable, copy-paste-ready commands throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://advancedcustomfields.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input {...} --json', plus a concrete proxy flag table. It is not 5 because CONNECTION_ID/actionId remain unresolvable placeholders (no worked example of extracting an id from the ensure output), and the CLI invocation is inconsistent ('membrane' vs 'npx @membranehq/cli' in the polling step). It is clearly above 3, which would require pseudocode or missing key details. | 4 / 5 |
Workflow Clarity | The sequence (install → login → connection ensure → poll until READY → search actions → run actions → proxy fallback) is clear and includes genuine validation checkpoints: '--wait' long-polling, state-based branching on READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR, and 'After the user completes the action... poll again'. This matches 'Clear sequence with most checkpoints present; minor validation gaps' — the gap is the dangling 'skip to Step 2' reference where no section is labeled Step 2 (and a '1b' without a '1a'), which makes the numbered flow incoherent at one point. No destructive/batch-operation cap applies, so it stays above 3. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are referenced, so there are no broken or nested references; the single page is organized into clearly headed sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices). With no external references the structure is evaluated on its own organization, which fits 'Good structure; most content is appropriately placed; minor organization gaps' — the proxy flag table and clientAction state-machine detail are candidates for a reference file if the skill grows. It is not 5 because at ~140 lines with no pointers to deeper material, some inline content (proxy options, error-state details) is denser than an overview should be. | 4 / 5 |
Total | 15 / 20 Passed |