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 body is a solid, command-driven guide with strong actionability and a real validation checkpoint in the connection-state polling flow. Its main weaknesses are modest padding (platform explainer, bare entity list, duplicated discovery command), broken step numbering with dangling 'Step 2' references, and the absence of a concrete worked example showing a real Chatwoot action end to end.
Suggestions
Delete the opening 'Chatwoot is an open-source customer engagement platform' paragraph and the entity-name list (or compress it into one line); Claude either knows Chatwoot or doesn't need the enumeration.
Fix the broken flow numbering: replace the dangling 'skip to Step 2' references and the lone '#### 1b' heading with a consistent, labeled step sequence (e.g. Step 1: connect, Step 2: discover actions, Step 3: run).
Add one worked example with real values — e.g. discovering and running a Chatwoot action to list or create a contact with its --input JSON and expected output field — so the action flow is demonstrated, not just parameterized.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean commands and flags, but includes unnecessary material Claude already knows or can't act on: the opening platform explainer ('Chatwoot is an open-source customer engagement platform...'), a bare entity list with no accompanying guidance, and the discovery command duplicated in both 'Searching for actions' and 'Popular actions'. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where over-explanation would be only minor. | 3 / 5 |
Actionability | Nearly all guidance is concrete and copy-paste ready — install, login, connection ensure/get with polling flags, action list/run with --input JSON examples, and a proxy command with a full flag table — matching anchor 4 ('mostly executable guidance with minor gaps'). It falls short of anchor 5 because every example uses generic placeholders (CONNECTION_ID, QUERY, <actionId>) with no worked example of a real Chatwoot action and its input/output, and the dangling 'Step 2' references leave one instruction unresolvable. | 4 / 5 |
Workflow Clarity | The sequence — install CLI, authenticate, ensure connection, poll state, discover actions, run, proxy fallback — is clear and includes a genuine validation checkpoint: the connection state branching (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) with re-polling after user action. Minor gaps keep it at anchor 4 rather than 5: the numbered flow is broken ('#### 1b' with no 1a or Step 2, two 'skip to Step 2' references to a nonexistent section) and there is no error-recovery guidance for failed action runs. | 4 / 5 |
Progressive Disclosure | This is a single-file skill (~145 lines) with no bundle directories, and the body is organized into clear, well-ordered sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with nothing buried — matching anchor 4 ('good structure; most content is appropriately placed; minor organization gaps'). It does not reach 5 because the proxy flag table, the clientAction state-machine detail, and the agent-types note are inline reference material that could be split into a one-level-deep references file to keep SKILL.md a leaner overview. | 4 / 5 |
Total | 15 / 20 Passed |