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.
Highly actionable content with executable commands and a well-validated connection workflow. The main weakness is conciseness: a marketing-style overview and several filler clauses add tokens that do not aid execution.
Suggestions
Trim the opening overview paragraph and remove filler clauses like 'so you can focus on the integration logic rather than auth plumbing' to improve token efficiency.
Consider moving the Popular actions table and Proxy flag reference into a separate reference file to lift progressive disclosure toward a leaner SKILL.md overview.
Add a brief note cautioning verification before the delete-* actions (delete-dispatch, delete-submission) listed in the Popular actions table, since destructive operations currently lack any validation guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The command examples are efficient, but the opening marketing paragraph ('GoCanvas is a mobile platform that helps businesses automate data collection...') and filler clauses ('so you can focus on the integration logic rather than auth plumbing', 'Those will be used to adjust tooling to be used best with your harness') add padding Claude does not need. | 3 / 5 |
Actionability | Copy-paste ready commands throughout (npm install, membrane login, connection ensure, action list/run, request) plus a concrete Popular actions table with exact keys fully cover the common cases. | 5 / 5 |
Workflow Clarity | The connection workflow is clearly sequenced with explicit state checkpoints (READY, BUILDING, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) and a poll-after-action feedback loop; steps are scattered across headers rather than one numbered flow, leaving minor gaps. | 4 / 5 |
Progressive Disclosure | Content is well organized into clear sections (Overview, Authentication, Connecting, Searching, Actions, Proxy, Best practices) and is self-contained with no bundle files present; at over 150 lines it is not the simple-skill 5, and some inline reference material could be split out. | 4 / 5 |
Total | 16 / 20 Passed |