Content
75%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 and a well-structured connection workflow, weakened only by a marketing-flavored intro and the absence of result verification after running actions.
Suggestions
Trim the marketing intro and filler phrases ('so you can focus on…', 'Use action names and parameters as needed.') to recover tokens.
Add an explicit verification step after 'membrane action run', e.g. check the output field and handle empty/error results before reporting success.
Consider moving the Popular actions table into a references file to keep SKILL.md a lean overview with a one-level pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is lean command reference, but the marketing intro ('used by marketers, sales teams, and growth hackers') and filler like 'so you can focus on the integration logic rather than auth plumbing' add unnecessary tokens. | 3 / 5 |
Actionability | It provides copy-paste ready commands for install, login, connection ensure, action list/run, and proxy requests, plus a Popular actions table with concrete action keys covering the common cases. | 5 / 5 |
Workflow Clarity | The connection setup is a clear sequenced state machine with polling feedback loops and explicit handling of READY/BUILDING/CLIENT_ACTION_REQUIRED/error states, though running actions lacks an explicit output-validation checkpoint. | 4 / 5 |
Progressive Disclosure | No bundle files exist; the single SKILL.md is organized with clear section headers and no nested references, though the Popular actions reference table is inlined rather than split out. | 4 / 5 |
Total | 16 / 20 Passed |