Content
52%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 CLI usage guidance is executable and reasonably well-sequenced with a polling feedback loop, but the document is dragged down by a massive inlined entity catalog with no external reference files and a broken "skip to Step 2" cross-reference. Moving the catalog to a reference file and fixing the step labels would substantially improve it.
Suggestions
Move the ~460-line entity catalog into a separate references file (e.g. references/entities.md) and replace the inline list with a one-line pointer, so SKILL.md stays a lean overview.
Fix the dangling "skip to Step 2" reference — either label the action-search section as "Step 2" or reword to "skip to Searching for actions" — so the workflow navigation is coherent.
Trim the duplicated "File <Entity>" variant list, which adds no actionable guidance over the base entity list and roughly doubles the token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body inlines a ~460-line catalog of entity names (the raw list at lines 23–128 then the same list duplicated with a "File" prefix at lines 129–259) plus a one-line "Use action names and parameters as needed", which is heavily padded reference material Claude gains little from; the CLI sections themselves are lean, so it is noticeably rather than severely verbose. | 2 / 5 |
Actionability | It provides concrete, copy-paste-ready CLI commands throughout (npm install, membrane login, connection ensure, action list/run with --json, request proxy) with real flags documented in a table, leaving only minor gaps such as the undefined CONNECTION_ID source. | 4 / 5 |
Workflow Clarity | The connection setup is sequenced (ensure → poll until READY → handle CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR → search actions → run/proxy) with a state-based feedback loop, but the dangling "skip to Step 2" reference (no labeled Step 2 exists, only "1b") is a minor gap keeping it below 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the giant entity catalog that clearly belongs in a separate reference file is inlined directly in SKILL.md, matching the anchor where content that should be split out is inlined; the CLI sections have headers but overall structure is minimal. | 2 / 5 |
Total | 12 / 20 Passed |