Content
82%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 a strong, executable guide: concrete CLI commands cover connection, action discovery/execution, and proxy fallback, with a well-sequenced connection workflow and explicit state-check feedback loops. The main weaknesses are minor over-explanation in the intro and a dangling "Step 2" reference that has no matching labeled section.
Suggestions
Add an explicitly labeled "## Step 2: Run an action" (or similar) section so the "skip to Step 2" references resolve to a real anchor.
Trim the introductory paragraph and the "focus on the integration logic rather than auth plumbing" phrasing to keep only what Claude does not already know.
Consider splitting the full action catalog / proxy flag reference into a `references/` file and linking to it, keeping SKILL.md as a tighter overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, copy-paste command examples with minimal prose. It has minor over-explanation (the opening paragraph describing what Formcarry is, and "so you can focus on the integration logic rather than auth plumbing") that could be trimmed. Matches anchor 4; not 5 because of that mild padding, not 3 because the bulk is efficient. | 4 / 5 |
Actionability | Concrete, executable commands are given throughout — `membrane connection ensure`, `membrane login complete <code>`, `membrane action run ... --input`, `membrane request` — covering connection, action discovery/execution, and proxy fallback. Matches anchor 5 (fully executable, copy-paste ready, covers common cases). | 5 / 5 |
Workflow Clarity | The connection flow is clearly sequenced with state-based validation checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and an explicit poll-and-retry feedback loop. Below anchor 5 because the "skip to Step 2" reference points to a section that is not explicitly labeled "Step 2", leaving a minor navigation gap; above anchor 3 because checkpoints and error handling are present. | 4 / 5 |
Progressive Disclosure | Content is organized into clear, well-signaled sections (Install, Authentication, Connecting, Searching actions, Popular actions, Running actions, Proxy, Best practices) with no nested/deep references and no bundle files to misplace. Below anchor 5 because some inline reference material (the Popular actions table and proxy flag table) is modest and could warrant a dedicated reference, but overall placement is good. | 4 / 5 |
Total | 17 / 20 Passed |