Content
68%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 delivers highly actionable, copy-paste CLI guidance organized in clear sections, but is let down by a padded marketing intro, a dangling 'Step 2' reference, and the absence of validation checkpoints around destructive action execution.
Suggestions
Remove the opening platform-marketing paragraph and 'auth plumbing' fluff; let the skill open with the install/connect workflow.
Define the referenced 'Step 2' explicitly (or renumber sections) so the 'skip to Step 2' instruction resolves to a concrete heading.
Add a validation/verification checkpoint before destructive or batch action runs and proxy DELETE/PUT calls (e.g. confirm scope or read-then-write) to raise workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient CLI commands, but the opening marketing paragraph ('platform for building online forums... used by businesses and individuals') and 'so you can focus on the integration logic rather than auth plumbing' are unnecessary padding Claude does not need. | 3 / 5 |
Actionability | Copy-paste-ready executable commands with clearly marked placeholders (CONNECTION_ID, QUERY, actionId, <agentType>) cover install, auth, connect, search, run, and proxy use cases. | 5 / 5 |
Workflow Clarity | The connection phase has an explicit state-machine (READY/BUILDING/CLIENT_ACTION_REQUIRED) with re-poll checkpoints, but the text references an undefined 'Step 2' and there is no validation around potentially destructive action runs or proxy DELETE requests, capping clarity at 3. | 3 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clear sections with no nested references and no bundle files to mis-signal; at ~150 lines it exceeds the under-50-line 5-exception, and 'Popular actions' partly duplicates 'Searching for actions', leaving minor gaps. | 4 / 5 |
Total | 15 / 20 Passed |