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 concrete, copy-paste CLI commands and a well-sequenced connection workflow with genuine state feedback loops. Its main weaknesses are verbose inline reference enumerations and a couple of dangling internal step labels ('Step 2', '1b').
Suggestions
Move the 16-model Train/Predict enumeration and the Popular actions table into a separate references file, keeping only a concise summary inline in SKILL.md.
Fix the dangling 'Step 2' reference and relabel '1b' with a matching '1a' so the connection sequence is internally consistent.
Remove filler lines like 'Use action names and parameters as needed.' that assume no new information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient structured reference, but the ~50-line Train/Predict enumeration for 16 models and the 14-row Popular actions table are repetitive inline content that could be tightened, and "Use action names and parameters as needed." is filler. | 3 / 5 |
Actionability | It provides copy-paste ready, fully specified commands with flags throughout (npm install, membrane login, connection ensure, action list/run, request), covering the common install-auth-connect-search-run cases with concrete placeholders. | 5 / 5 |
Workflow Clarity | The connection workflow has a clear sequence with explicit state feedback loops (poll until READY, handle CLIENT_ACTION_REQUIRED then re-poll, check error states), but the referenced 'Step 2' and '1b' labels are not cleanly defined, leaving minor navigation gaps. | 4 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers and no nested external references, but no bundle files exist and large inline enumerations (model list, actions table) that could live in a separate reference file are kept in SKILL.md, a minor organization gap for a 200+ line skill. | 4 / 5 |
Total | 16 / 20 Passed |