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 a strong, executable guide: concrete Membrane CLI commands, a clear connection-readiness state machine with a feedback loop, and a useful proxy table. Its main weaknesses are a dangling 'Step 2' reference and a small amount of trimmable prose.
Suggestions
Define or remove the undefined 'Step 2' anchor so the connection workflow does not reference a missing section.
Trim atmospheric prose ('Think of it as Git for data', 'focus on the integration logic rather than auth plumbing') to tighten token use.
Consider moving the clientAction field reference and the proxy flag table into reference files and linking to them for a leaner SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, leaning on executable commands and a flag table with only minor over-explanation ('Think of it as Git for data', 'so you can focus on the integration logic rather than auth plumbing'); it fits anchor 4 (efficient, minor trimmable instances) and not 5 because a few prose asides do not fully earn their tokens. | 4 / 5 |
Actionability | Commands are copy-paste ready and cover the common cases end to end ('npm install -g @membranehq/cli@latest', 'membrane connection ensure', 'membrane action run ... --input', the proxy flag table); it matches anchor 5 (fully executable, specific examples cover common cases) rather than 4 since there are no real gaps. | 5 / 5 |
Workflow Clarity | The connect-to-ready flow is a clear sequence with an explicit state machine and a poll-again feedback loop (READY / BUILDING / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), but the dangling 'skip to Step 2' reference points to a Step 2 that is never defined, a minor gap that caps it at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the skill is a single self-contained file with clear section headers and easy navigation, fitting anchor 4 (good structure, well-placed content); it does not reach 5 because some inline material (the clientAction field reference and the proxy flag table) could be split into reference files to keep SKILL.md leaner. | 4 / 5 |
Total | 17 / 20 Passed |