Content
71%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 skill is highly actionable with concrete, executable Membrane CLI commands and a clear connection workflow with polling checkpoints. Its main weaknesses are an oversized inline entity list that hurts token efficiency and the absence of any reference files to offload catalog material.
Suggestions
Move the 75-item entity/activity enumeration into a references file (e.g. ENTITIES.md) and keep only the core resource types inline, relying on 'membrane action list' for discovery.
Number the workflow steps consistently and resolve the dangling 'Step 2' reference so the connect-to-action flow is unambiguous.
Split the proxy flags reference into a short inline summary plus a separate reference file to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The CLI command examples are lean and assume competence, but the ~75-item entity/activity enumeration (lines 23-97) is a substantial token spend that duplicates what 'membrane action list' can discover, so the body could be tightened. | 3 / 5 |
Actionability | Commands are copy-paste ready throughout (install, login, connection ensure/get, action list/run, request) with a concrete flags table and JSON examples covering the common cases. | 5 / 5 |
Workflow Clarity | There is a clear sequence (install -> authenticate -> connect -> poll for READY -> search -> run) with state-based polling checkpoints and a retry loop for CLIENT_ACTION_REQUIRED, though the 'Skip to Step 2' references are slightly dangling since steps are not consistently numbered. | 4 / 5 |
Progressive Disclosure | Headers give the body structure, but with no bundle files present the large entity catalog and proxy reference material are inlined in SKILL.md rather than split into one-level-deep reference files. | 3 / 5 |
Total | 15 / 20 Passed |