Content
60%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 command-dense and actionable with a clear connection-state workflow, but its quality is undermined by a stray refusal paragraph at the top and redundant action-discovery sections. Structure is good for a single-file skill with no bundle.
Suggestions
Delete the opening 'I don't have enough information to do that...' paragraph; it is irrelevant noise that wastes tokens and confuses the skill's purpose.
Merge the redundant 'Searching for actions' and 'Popular actions' sections, which both demonstrate `membrane action list --intent=QUERY`.
Add an explicit validate-before-act checkpoint for destructive or batch actions (e.g., confirm task/list changes before running mutating actions) to strengthen workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body opens with an irrelevant canned refusal ('I don't have enough information to do that. I'm a large language model...') that is pure padding, and the 'Searching for actions' and 'Popular actions' sections repeat the same discovery command, making it noticeably verbose despite otherwise command-focused content. | 2 / 5 |
Actionability | Provides concrete, executable commands throughout (npm install, membrane login, connection ensure, action run, request) that are mostly copy-paste ready; it stops short of 5 because parameters like CONNECTION_ID are placeholders and the 'Height Overview' entity list gives no actionable detail. | 4 / 5 |
Workflow Clarity | Sequences install -> authenticate -> connect -> poll for readiness -> search -> run, with state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and error-field guidance; minor gaps (a 'Step 2' reference under a '1b' heading, no pre-run validation for destructive actions) keep it at 4. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content is inline in one well-sectioned file (Overview, Authentication, Connecting, Searching, Proxy, Best practices) with clear headers and easy navigation; it is not a 5 because some reference-like content (the proxy flag table, best practices) could be split out. | 4 / 5 |
Total | 14 / 20 Passed |