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 strong, executable guide with a clear connection workflow and concrete commands, held back mainly by minor verbosity and marketing-flavored prose. It is well-structured and largely copy-paste ready.
Suggestions
Trim explanatory/marketing prose such as "so you can focus on the integration logic rather than auth plumbing" and the "Developers and businesses use it..." sentence to respect Claude's existing knowledge.
Make the CONNECTION_ID placeholder explicit (e.g. show how to capture it from the `connection ensure --json` output) so the run/search commands are fully end-to-end executable.
Consider moving the proxy flags reference table into a references file to keep SKILL.md a lean overview, since the skill already exceeds ~140 lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but includes unnecessary padding such as the marketing-style "so you can focus on the integration logic rather than auth plumbing" and the general-purpose description of who uses MSG91, which Claude already knows. | 3 / 5 |
Actionability | It provides copy-paste-ready commands throughout (install, login, connection ensure, action list/run, request) with a clear flags table for proxying, with only minor gaps such as unresolved CONNECTION_ID placeholders. | 4 / 5 |
Workflow Clarity | The install → authenticate → connect → wait → search → run sequence is clear with state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and a polling feedback loop, though a couple of transitions are implicit. | 4 / 5 |
Progressive Disclosure | Content is organized into clear, well-labeled sections with no nested references, and the proxy/action material is reasonably placed inline; there are no bundle files, and a few sections (e.g. the proxy flags) could arguably live in a reference. | 4 / 5 |
Total | 15 / 20 Passed |