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 content is highly actionable with executable CLI commands and a sensible state-aware connection workflow, supported by clean sectioning. The main weaknesses are minor prose padding and inconsistent step numbering that breaks the otherwise clear sequence.
Suggestions
Remove marketing filler ("Their products are used by governments, enterprises, and financial institutions" and the "focus on the integration logic rather than auth plumbing" aside) to tighten token efficiency.
Normalize the workflow numbering so "Step 2" and "1b" references resolve to actual labeled steps (e.g., Step 1 connect, Step 2 search actions, Step 3 run), clarifying the main path.
If the action catalog or proxy details grow, split them into a reference file (e.g., ACTIONS.md) referenced one level deep to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean CLI commands and an options table, but includes minor padding such as "Their products are used by governments, enterprises, and financial institutions" and "so you can focus on the integration logic rather than auth plumbing", fitting the level-4 "efficient; minor over-explanation" anchor. | 4 / 5 |
Actionability | It provides copy-paste-ready, executable commands throughout (npm install, membrane login, connection ensure, action list/run, request proxy) plus a concrete flags table, matching the level-5 "fully executable; specific examples cover the common cases" anchor. | 5 / 5 |
Workflow Clarity | There is a clear install → login → connect → wait → search → run sequence with state-machine validation (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll-again feedback loop, but the "Step 2" / "1b" labels reference steps that are not consistently numbered, leaving minor gaps at level 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clear sections (Overview, Working with, Install, Auth, Connecting, Searching, Popular actions, Best practices) with no nested references, but at ~140 lines with all content inlined and no bundle files it sits at level 4's "good structure, minor organization gaps" rather than the minimal-overview level 5. | 4 / 5 |
Total | 17 / 20 Passed |