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.
The body is highly actionable with concrete, copy-paste-ready CLI commands and a well-structured connection state machine, but it carries some conceptual/marketing padding and a broken "Step 2" cross-reference that slightly undercut conciseness and workflow clarity.
Suggestions
Trim the opening paragraph and marketing phrasing (e.g. "so you can focus on the integration logic rather than auth plumbing") to assume Claude's competence and save tokens.
Fix or remove the dangling "skip to Step 2" references, since no Step 2 section exists in the document.
Consider moving the clientAction state-machine details and the proxy flags table into a referenced reference file to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but includes unnecessary padding such as the opening "ClickFunnels Classic is a platform that helps users build sales funnels..." concept explainer and marketing-style lines like "so you can focus on the integration logic rather than auth plumbing", fitting anchor 3. | 3 / 5 |
Actionability | It provides copy-paste-ready commands throughout (npm install, membrane login, connection ensure, action list/run, request) plus a concrete flags table, covering the common cases fully as in anchor 5. | 5 / 5 |
Workflow Clarity | The connection flow is a clear sequence with explicit state checkpoints (READY, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) and a poll-again feedback loop, but the dangling "skip to Step 2" reference with no corresponding Step 2 section and absent post-run validation leave minor gaps, fitting anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the single SKILL.md is well-organized with clear section headers covering install, auth, connection, actions, proxy, and best practices, but at ~140 lines some content (the flags table, clientAction state machine) could be split into referenced files, matching anchor 4. | 4 / 5 |
Total | 16 / 20 Passed |