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 action-dense and well-structured, with an explicit state-driven connection workflow that includes feedback loops, making it genuinely usable. Its main weaknesses are minor verbosity in introductory prose, a few placeholder/inconsistency gaps in commands, and a dangling 'Step 2' cross-reference.
Suggestions
Trim the generic opener and auth-plumbing prose to lift conciseness toward lean, command-focused content.
Reconcile the `membrane` vs `npx @membranehq/cli@latest` invocation styles and show how to obtain CONNECTION_ID/actionId from prior command output to close actionability gaps.
Fix the dangling 'Skip to Step 2' reference by adding a labeled Step 2 heading or rewriting the pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with executable commands, but includes some unnecessary prose such as the generic opener 'is a data management platform... discover its full capabilities' and 'so you can focus on the integration logic rather than auth plumbing', matching the 'Mostly efficient but includes some unnecessary explanation or could be tightened' anchor; it is below 4 due to these padding spots and above 2 because the bulk is concrete. | 3 / 5 |
Actionability | It provides concrete, mostly copy-paste-ready bash commands (login, connection ensure, action list/run, request) covering the common cases, matching 'Mostly executable guidance; concrete code or commands with minor gaps'; it does not reach 5 because placeholders like <actionId> and CONNECTION_ID require substitution and there is inconsistency between `membrane` and `npx @membranehq/cli` invocations. | 4 / 5 |
Workflow Clarity | The connection setup is a clear state-driven sequence with explicit checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and feedback loops (poll until ready, re-poll after user action), matching 'Clear sequence with most checkpoints present; minor validation gaps'; it is capped below 5 by a dangling 'Skip to Step 2' reference with no corresponding Step 2 heading. | 4 / 5 |
Progressive Disclosure | The skill is a single self-contained SKILL.md with well-organized sections and no nested references, matching 'Good structure; most content appropriately placed; minor organization gaps'; it is below 5 because at ~150 lines some content (the proxy options table, clientAction schema) could be split out, and above 3 because sections are clearly headed and navigable. | 4 / 5 |
Total | 15 / 20 Passed |