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 content is well-structured and highly actionable, with executable commands and a connection workflow that includes real validation checkpoints. The main weaknesses are mild marketing prose that could be trimmed and a dangling 'Step 2' reference that breaks the workflow numbering.
Suggestions
Define or remove the undefined 'Step 2' reference so the connection-to-action flow has a coherent numbered sequence.
Trim promotional prose such as 'so you can focus on the integration logic rather than auth plumbing' to keep the body lean.
Add at least one fully-resolved action example (real actionId and input JSON) to turn the generic placeholders into copy-paste-ready guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient command blocks and tables, but includes padding such as 'so you can focus on the integration logic rather than auth plumbing' and 'Use the available actions to discover its full capabilities', fitting 'mostly efficient but includes some unnecessary explanation'. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready commands with flags for install, login, connection, search, run, and proxy, but relies on generic placeholders (CONNECTION_ID, QUERY, actionId) without a fully worked example, matching 'mostly executable guidance with minor gaps'. | 4 / 5 |
Workflow Clarity | The connection flow has a clear sequence with explicit state-polling validation and feedback loops (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), but it references an undefined 'Step 2', leaving a minor sequencing gap. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clear sections (Authentication, Connecting, Searching, Proxy, Best practices) with no bundle files needed, though the proxy flags table and connection-state detail could be split out, matching 'good structure with minor organization gaps'. | 4 / 5 |
Total | 15 / 20 Passed |