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 content is action-dense with concrete Membrane CLI commands and a solid connection-state feedback loop, but it is held back by background/marketing prose, a low-value "No description" actions table, inconsistent step numbering, and a lack of destructive-action validation or external reference splitting.
Suggestions
Remove the n8n background sentence and the "focus on the integration logic rather than auth plumbing" prose, and drop or populate the Popular actions "No description" rows to cut padding.
Fix the step numbering (define Step 1a/1b and a clearly labeled Step 2) and add a validation checkpoint before destructive actions like delete-workflow (e.g., confirm the target ID and re-list to verify removal).
Move the full Popular actions / proxy flag reference into a separate reference file linked from SKILL.md so the overview stays lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient command examples, but trimmable padding exists: the opener "N8n is a fair-code workflow automation platform. It allows developers and power users..." explains concepts Claude knows, marketing prose ("so you can focus on the integration logic rather than auth plumbing"), and a 20-row Popular actions table whose every row says "No description". | 3 / 5 |
Actionability | Concrete copy-paste commands cover install, login, connection ensure/get with --wait, action list/run with --input, and proxy requests with a full flag table; minor gaps remain since the Popular actions table carries "No description" entries and commands rely on placeholders like CONNECTION_ID and <actionId>. | 4 / 5 |
Workflow Clarity | The connection flow has good feedback loops (poll until state leaves BUILDING, branch on READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR, re-poll after user action), but step numbering is inconsistent ("skip to Step 2" and "#### 1b" with no 1a or labeled Step 2) and the destructive "Delete Workflow" action has no validation/verification step, capping this at 3 per the destructive-operations rule. | 3 / 5 |
Progressive Disclosure | The body has clear section headers (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) but no bundle files and no external references; at ~160 lines with a large inline Popular actions table that would benefit from being a separate reference, it sits at anchor 3 rather than the well-split anchor 5. | 3 / 5 |
Total | 13 / 20 Passed |