Content
63%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 actionable with executable commands and a clear, validated connection workflow, but it carries marketing/filler prose and keeps detailed reference material inline in a single file instead of offloading it. Strengths are actionability and workflow clarity; weaknesses are conciseness and progressive disclosure.
Suggestions
Trim the marketing intro and filler ('Use action names and parameters as needed', 'so you can focus on the integration logic') to assume Claude's competence.
Move the proxy flag table and clientAction state-handling detail into a referenced file (e.g. references/connection-states.md) and link to it from SKILL.md.
Resolve the 'skip to Step 2' reference by labeling the action-search/run section as Step 2 so the workflow sequence is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but includes padding Claude does not need: the marketing intro ('Cumul.io is an embedded analytics platform that allows SaaS companies...'), 'so you can focus on the integration logic rather than auth plumbing', and the filler line 'Use action names and parameters as needed.' | 3 / 5 |
Actionability | It provides copy-paste-ready membrane CLI commands for install, auth, connection, action list/run, and proxy requests plus a flag table, fitting 'mostly executable guidance with minor gaps' — the remaining placeholders (CONNECTION_ID, QUERY) require user-supplied values. | 4 / 5 |
Workflow Clarity | The install → auth → connect → poll sequence is clear with explicit state feedback loops (READY, BUILDING, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) and a re-poll instruction, matching level 4; the dangling 'skip to Step 2' reference with no matching labeled Step 2 is a minor checkpoint gap. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the body references no offloaded materials; content is organized by headers but detailed reference material (the proxy flag table, clientAction state handling) is inlined in a single ~159-line file rather than split into a clearly signaled one-level-deep reference. | 3 / 5 |
Total | 14 / 20 Passed |