Content
82%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 highly actionable with executable commands throughout and a clear connect-to-run workflow. Its weaknesses are mild verbosity in a few prose patches, a lack of validation guidance around destructive conversation operations, and the absence of reference files for the inlined action/flag catalogs.
Suggestions
Add a validation/verification step for destructive operations, e.g. confirm a conversation is the intended target and verify the deletion succeeded via the command output before reporting success.
Move the Popular actions table and proxy flag table into a references/ file (e.g. ACTIONS.md) and link to it from the body to keep SKILL.md a lean overview.
Trim explanatory prose like "This is the fastest way to get a connection… The URL is normalized…" down to the essential behavior, and fix the Step 1b / Step 2 numbering so the sequence reads cleanly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most sections are lean command blocks with brief, useful commentary (state transitions, --wait, --json), but a few prose passages ("This is the fastest way to get a connection…") and the inlined 15-row action table and proxy-flag table add tokens that could be trimmed. | 4 / 5 |
Actionability | Every workflow gives concrete, copy-paste-ready membrane commands with flags and example inputs (connection ensure, action list --intent, action run --input, request), covering the common search/run/proxy cases. | 5 / 5 |
Workflow Clarity | The connect -> poll -> search -> run flow is clearly sequenced with state-transition branches and a re-poll feedback loop, but destructive actions ("Permanently delete a conversation") ship with no validation/verification guidance, and the Step 1b/Step 2 numbering is slightly inconsistent. | 4 / 5 |
Progressive Disclosure | The single self-contained document is well-organized with clear headers, but there are no bundle/reference files, so the bulk Popular-actions catalog and proxy-flag table are inlined rather than split into a one-level-deep reference. | 4 / 5 |
Total | 17 / 20 Passed |