Content
63%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 well-organized, command-rich integration guide with a strong connection workflow including polling and state-handling checkpoints. It is held back by minor verbosity/redundancy and by being a single monolithic file rather than splitting detailed reference material into separate files.
Suggestions
Tighten or remove explanatory padding such as 'so you can focus on the integration logic rather than auth plumbing' and consolidate the repeated membrane/npx CLI invocation forms into one canonical pattern.
Move the detailed proxy flag reference and the connection-state handling into a separate references file (e.g. REFERENCES.md) and link to it from SKILL.md to improve progressive disclosure.
Add an explicit error-recovery step for action runs (e.g., how to inspect the output/error field and retry), turning the action workflow into a validate-then-retry feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command- and table-driven and reasonably lean, but includes some removable explanation ('so you can focus on the integration logic rather than auth plumbing'), a brief platform primer Claude largely knows, and repeated CLI invocation variants (membrane vs npx @membranehq/cli) that could be tightened — fitting 'mostly efficient but with some unnecessary explanation'. | 3 / 5 |
Actionability | Concrete, copy-paste-ready commands are provided throughout (install, login, connection ensure with --json, action run, proxy with a full flag table), covering the common cases; minor gaps remain in the form of unfilled placeholders (CONNECTION_ID, <actionId>, 'QUERY'), placing it just below fully executable across all cases. | 4 / 5 |
Workflow Clarity | The connection setup is a clear sequence with explicit validation checkpoints — --wait polling, state branching (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), and re-poll after user action — which provides feedback loops; it is not a 5 because the action-running and proxy sections lack an explicit error-recovery checklist. | 4 / 5 |
Progressive Disclosure | No bundle files exist and all content lives in a single ~145-line SKILL.md with good section headers, but nothing is split out to references and no external file pointers are signaled; this matches 'some structure but content that could be separate is inline', and the size exceeds the under-50-line simple-skill exception. | 3 / 5 |
Total | 14 / 20 Passed |