Content
61%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, command-driven integration guide with genuinely actionable CLI examples and good state-handling guidance for connections. The main deductions are mild marketing/aside padding, a broken step-reference scheme ("Step 2" and "1b" without matching labels), and — most significantly — destructive actions (deletes) offered with no validation or confirmation workflow, which caps workflow clarity.
Suggestions
Add validation guidance around destructive operations: confirm the target ID with the user before delete-post/delete-user/delete-comment, and verify with a get/list call afterward (this lifts the workflow_clarity cap).
Fix the incoherent step labels — "skip to Step 2" points to a step that doesn't exist, and "#### 1b" has no matching "1a"; either number the steps consistently or drop the labels.
Trim padding: cut the product-marketing intro sentence and the "Agent Types" aside (or compress it to a parenthetical on the login command), and clarify the "--tenant" flag's value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command-first and efficient, but contains unnecessary padding: the intro paragraph ("helps product teams keep users informed and engaged") is product-marketing context Claude doesn't need, and the "Agent Types : claude, openclaw, codex, warp, windsurf, etc." aside with its ungrammatical trailing sentence adds little. Fits anchor 3 (mostly efficient, some unnecessary explanation) rather than anchor 4, since there are several such spots, not just minor instances. | 3 / 5 |
Actionability | Commands are concrete and executable throughout — "npm install -g @membranehq/cli@latest", "membrane connection ensure \"https://www.getbeamer.com/\" --json", the action run/proxy flag tables, and an 18-row action catalog. Falls short of anchor 5 only on minor gaps: no filled-in example of running a specific action with a real --input payload, and "membrane login --tenant --clientName=<agentType>" is ambiguous (--tenant takes no shown value). | 4 / 5 |
Workflow Clarity | The install → login → connect → wait → search → run sequence is present with a state-based feedback loop (CLIENT_ACTION_REQUIRED → poll again until READY). However, the flow references "skip to **Step 2**" when no numbered steps or Step 2 exist (and "1b" appears with no "1a"), and the skill exposes destructive operations (Delete Post, Delete User, Delete Comment) with no validation/confirmation guidance — per the rubric cap, destructive operations without validation steps cap workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | The single file is well-organized with clear section headers (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) and no nested references. It falls short of anchor 5 because the 18-row action catalog and proxy options table are bulk reference material that could live in a separate file, keeping the SKILL.md body leaner. Not anchor 3, since nothing is buried and structure is consistent. | 4 / 5 |
Total | 14 / 20 Passed |