Content
71%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 highly actionable, with executable commands and a clear connection-state feedback loop, but is mildly verbose in places and ships as a single monolithic file with no progressive disclosure to separate reference materials. A broken 'Step 2' cross-reference is the main workflow-clarity blemish.
Suggestions
Move the entity list, proxy flag table, and clientAction schema into one-level-deep reference files (e.g. ENTITIES.md, PROXY.md) and link to them from SKILL.md.
Fix the 'skip to Step 2' reference by either adding an explicit '## Step 2' heading or relabeling it to the actual target section.
Trim editorializing (the ManyChat marketing-automation intro, 'burn less tokens', 'focus on the integration logic') to keep the body lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient command-driven prose, but includes removable padding such as the opening paragraph explaining what ManyChat is and editorializing like 'so you can focus on the integration logic rather than auth plumbing' and 'This will burn less tokens'. | 3 / 5 |
Actionability | It provides copy-paste-ready commands for every stage (install, login, connection ensure, action list/run, request) with concrete flags, a proxy flag table, and JSON-output examples covering the common cases. | 5 / 5 |
Workflow Clarity | There is a clear install → authenticate → connect → poll-until-ready → search → run sequence with a real feedback loop on connection state (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), but 'skip to Step 2' references a Step 2 heading that does not exist, a minor validation/clarity gap. | 4 / 5 |
Progressive Disclosure | The file has reasonable section headers, but at ~150 lines with no bundle files it keeps everything inline (full entity list, proxy flag table, clientAction schema) that could live in one-level-deep reference files; no external references are signaled. | 3 / 5 |
Total | 15 / 20 Passed |