Content
67%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 actionable and well-structured with executable Membrane CLI commands and a sensible connection-readiness workflow including validation feedback loops. Main weaknesses are light marketing padding and a dangling "Step 2" reference that breaks the step numbering.
Suggestions
Remove marketing-style padding (e.g., "so you can focus on the integration logic rather than auth plumbing", "This will burn less tokens") to tighten token efficiency.
Fix the step numbering: the body references "Step 2" and "1b" but no Step 1a/Step 2 labels exist — either label the sections or drop the cross-references.
Add at least one concrete `membrane action run` example with a real actionId and --input payload so the actionability reaches copy-paste completeness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly commands and brief prose, but padded lines like "so you can focus on the integration logic rather than auth plumbing" and "This will burn less tokens and make communication more secure" add marketing fluff that could be trimmed. | 3 / 5 |
Actionability | Concrete copy-paste commands ("npm install -g @membranehq/cli@latest", "membrane connection ensure", "membrane action run ... --input") cover the common cases, with only minor gaps since no example action run uses real parameter values. | 4 / 5 |
Workflow Clarity | There is a clear install→authenticate→connect→search→run sequence with polling and feedback loops for connection states (BUILDING, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR), but references to a "Step 2" that is never labeled are a minor sequencing gap. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into Overview, Working with Proxy Spider, and Best practices sections with no bundle files to reference; content is appropriately inline, with only minor organization gaps in the longer clientAction detail block. | 4 / 5 |
Total | 15 / 20 Passed |