Content
68%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 commands and a strong connection workflow, but it loses points for an unnecessary introductory explanation and, critically, lacks validation guidance around destructive operations like member deletion. Organization is solid but monolithic.
Suggestions
Add an explicit validation/confirmation checkpoint before destructive actions (e.g. 'Before running delete-member, confirm the member ID with the user and consider listing the member first to verify').
Trim or remove the introductory paragraph explaining what Memberstack is and the empty Memberstack Overview bullet list, which add tokens without operational value.
Consider moving the full proxy flag table and Popular actions reference into a separate reference file, keeping SKILL.md as a concise overview with one-level-deep pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient executable CLI guidance, but the introductory paragraph explaining what Memberstack is (membership platform, logins, gated content, no-code solution) and the near-empty Memberstack Overview bullets are unnecessary background Claude does not need, matching 'mostly efficient but includes some unnecessary explanation'. | 3 / 5 |
Actionability | Provides fully executable, copy-paste-ready membrane CLI commands with flags across install, auth, connection, action search/run, and proxy, plus a concrete Popular actions table — specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The connection flow is well sequenced with explicit state checkpoints and a poll-after-action feedback loop, but destructive actions (e.g. 'Delete Member') are presented in a table with a generic run command and no validation checkpoint before execution, so the destructive-operation cap holds at 3. | 3 / 5 |
Progressive Disclosure | Well-organized with clear section headers and no nested references, but it is a monolithic ~150-line single file with inlined reference-style content (the proxy flag table and action list) that could be split; good structure with minor organization gaps rather than the content-splitting required for a 5. | 4 / 5 |
Total | 15 / 20 Passed |