Content
72%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.
A highly actionable CLI-driven skill with excellent copy-paste commands and state-handling guidance for the connection flow. Its main weaknesses are a dangling "Step 2" cross-reference, no validation guidance around destructive delete actions, and a monolithic single-file layout where an actions reference could be split out.
Suggestions
Fix the workflow numbering: the text says "skip to **Step 2**" but no Step 2 heading exists — label the connection, search, and run sections as explicit numbered steps and remove the orphan "1b" heading.
Add validation guidance for destructive actions: before running delete-datasource / delete-datastore / delete-agent, fetch the object with the corresponding get action to confirm the ID, and confirm with the user when deletion is irreversible.
Consider moving the full popular-actions table into a references/ file (e.g. ACTIONS.md) with a few flagship examples kept inline, and trim filler lines like "Use action names and parameters as needed."
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable commands and tables rather than concept explanations, with only minor trimmable filler ("Use action names and parameters as needed.", "This is the fastest way to get a connection.", and the awkward agent-types sentence). Matches anchor 4 (efficient, minor over-explanation), not 5 because a few sentences and the thin "Chaindesk Overview" bullet list don't earn their tokens. | 4 / 5 |
Actionability | Every step ships a copy-paste-ready command: `npm install -g @membranehq/cli@latest`, `membrane login`, `membrane connection ensure "https://www.chatbotgpt.ai/" --json`, action search/run with a concrete `--input '{"key": "value"}'` example, and a proxy flag table. The 15-row popular-actions table with action keys covers the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The connect → poll state → search → run sequence exists with state-based checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR handling), but "skip to **Step 2**" references a heading that never appears (steps are unnumbered apart from "1b"), and destructive actions (delete-datasource, delete-datastore, delete-agent) are listed with no verify-before-delete or confirmation guidance. The destructive/batch validation cap applies, holding this at 3 rather than 4. | 3 / 5 |
Progressive Disclosure | This is a single ~155-line file with no references/ or other bundle files — everything is inlined, including a 15-row actions table and the proxy flag reference that read like reference-file material. Section headers give decent navigation, but nothing is offloaded to a separate file, matching anchor 3 (some structure, content that could be separate is inline) rather than 4 (which expects most content appropriately split or placed). | 3 / 5 |
Total | 15 / 20 Passed |