Content
57%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 body is fundamentally actionable — real, executable Membrane CLI commands with a well-documented connection state machine — but it is marred by obvious corruption and sloppiness: a pasted LLM refusal paragraph, an official-docs URL pointing to an unrelated site, a dangling "Step 2" reference, and inconsistent heading structure. These defects cost it token efficiency and workflow coherence without adding any instructional value.
Suggestions
Delete the refusal paragraph ("I don't have enough information to do that...") immediately after the # CDR Platform heading — it is a stray LLM response, not skill instruction, and actively confuses the workflow.
Remove or correct the "Official docs" link: https://cdr.ffiec.gov/public/Pillar/Doc/Help is the FFIEC banking-regulator site, unrelated to this carbon-dioxide-removal platform (cdrplatform.com).
Fix the workflow's broken navigation: define the steps the "skip to **Step 2**" reference points to, rename "#### 1b" to a properly numbered step, and normalize heading levels so ## and ### sections nest consistently.
Add at least one complete example invocation of a popular action (e.g. `membrane action run purchase-cdr --input '{"amount": ...}'`) and clarify the `--tenant` flag's expected value in the login command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is lean — copy-paste CLI commands, tight tables, minimal prose — but it contains several sections of pure noise: an entire pasted LLM refusal paragraph ("I don't have enough information to do that. I'm a large language model...") with zero instructional value, an official-docs URL pointing at cdr.ffiec.gov (an unrelated FFIEC site, not this platform), and a bare entity list (Case, User, Tag...) with no explanation of what to do with it. Fits anchor 3 ("mostly efficient but includes some unnecessary explanation") — the padding is real but localized; anchor 2 would require the verbosity to dominate the document, which it doesn't. | 3 / 5 |
Actionability | The body provides concrete, executable commands throughout: `npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://cdrplatform.com" --json`, `membrane action run <actionId> --input '{"key": "value"}'`, plus a complete proxy flag table. Anchor 5 is missed due to minor gaps: the auth example `membrane login --tenant --clientName=<agentType>` leaves `--tenant` with no visible value, and the three "Popular actions" are described but never shown with a concrete example invocation. | 4 / 5 |
Workflow Clarity | A sequence exists (install → login → connection ensure → poll for READY → search actions → run), and the connection state machine (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR with clientAction handling) is a genuine checkpoint loop. But the flow is undermined by a dangling "skip to **Step 2**" reference to a Step 2 that never appears, an "#### 1b" heading with no 1a, inconsistent heading levels (### sections followed by ## Popular actions), and no validation of action results after running. Fits anchor 3 ("sequence present but checkpoints missing or implicit") rather than 4 due to the broken cross-references; the destructive/batch cap is not triggered as this is not a batch/destructive skill. | 3 / 5 |
Progressive Disclosure | There are no bundle files at all (no references/, scripts/, or assets/), so everything — CLI setup, connection lifecycle, proxy flag reference, action catalog — is inlined in a single ~150-line file with inconsistent heading hierarchy. This exceeds the under-50-line simple-skill exception, and content like the proxy flag table and entity catalog would be natural separate references. Fits anchor 3 ("some structure but could be better organized; content that should be separate is inline") — structure exists, so not anchor 2, but organization and splitting are clearly improvable. | 3 / 5 |
Total | 13 / 20 Passed |