Content
75%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 solid, command-driven integration skill: nearly everything is an executable Membrane CLI instruction with good state-handling detail for connection setup. The main weaknesses are a dangling "Step 2" reference from an abandoned numbering scheme, no concrete worked example of an actual Cacoo action, and light padding around the Membrane framing.
Suggestions
Fix the dangling references: "skip to **Step 2**" points to a step that does not exist — either introduce explicit numbered step headings (Step 1: Connect, Step 2: Discover actions, Step 3: Run) or remove the mentions.
Add one worked end-to-end example under Running actions, e.g. `membrane action list --connectionId=... --intent "list diagrams" --json` followed by running the returned action id for a common Cacoo task like fetching or creating a diagram.
Trim the padding: the opening paragraph explaining what Cacoo is and the agent-types enumeration line can be reduced to a few tokens without losing actionable content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable commands and a compact flag table, but includes minor padding such as "Cacoo is a user-friendly online diagramming tool. It's used by teams to collaborate..." and the agent-types list "claude, openclaw, codex, warp, windsurf, etc." that could be trimmed. Not 3 because the bulk is lean CLI instruction rather than explanation of known concepts; not 5 because the intro paragraph and Membrane marketing framing ("This is the fastest way to get a connection. The URL is normalized to a domain...") slightly over-explain. | 4 / 5 |
Actionability | Concrete, copy-paste-ready commands cover install ("npm install -g @membranehq/cli@latest"), auth ("membrane login --tenant --clientName=<agentType>"), connection ("membrane connection ensure \"https://cacoo.com/\" --json"), action discovery/run, and proxy flags. Not 5 because there is no worked example of a real Cacoo action (e.g., searching "list diagrams" and running a concrete actionId) — every invocation uses placeholders like CONNECTION_ID and <actionId> without a demonstrated end-to-end case. | 4 / 5 |
Workflow Clarity | A clear sequence is present (install → login → connection ensure → poll state → search actions → run / proxy) and the connection phase has genuine validation checkpoints (polling until state leaves BUILDING, explicit READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR handling and re-poll after user action). Not 5 because "skip to **Step 2**" is referenced twice but no Step 1/Step 2 headings exist (a dangling, incoherent reference), and running actions has no error-checking or output-validation guidance. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the body is reasonably well organized into clearly headed sections (Overview, Working with Cacoo, Popular actions, Best practices) with no nested or broken file references. Scored 4 rather than 5 because at ~145 lines the Cacoo overview entity tree and proxy flag table could partly live in a reference file, and the stray numbered-step convention ("1b", "Step 2") muddies navigation slightly. | 4 / 5 |
Total | 16 / 20 Passed |