Content
76%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 copy-paste CLI commands and a well-structured connection state machine, but loses points for missing validation around destructive actions and minor verbosity. Progressive disclosure is solid for a single-file skill though slightly long.
Suggestions
Add an explicit validation/confirmation step before destructive actions (e.g. 'Before delete-*, confirm the ID with a get-* call and verify with the user') to lift the workflow-clarity cap.
Trim padding such as 'so you can focus on the integration logic rather than auth plumbing' and condense the introductory CRM-description paragraph.
Consider moving the 20-row popular-actions table into a references file and linking to it, keeping only a few key examples inline, to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands and tables, but includes minor padding such as 'so you can focus on the integration logic rather than auth plumbing' and a slightly padded intro paragraph explaining what Follow Up Boss is. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the full path: install (`npm install -g @membranehq/cli@latest`), login, `connection ensure`, `action list/run`, and `request` proxy, plus a populated popular-actions table and proxy flag table. | 5 / 5 |
Workflow Clarity | The connection workflow has a clear sequence with explicit polling/state validation (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), but the skill exposes destructive actions (delete-person, delete-deal, delete-task) with no validation or verification guidance, which caps workflow clarity at 3 per the destructive-operations rule. | 3 / 5 |
Progressive Disclosure | Well-organized into clear sections with no nested references and no bundle files to navigate; at ~165 lines the large popular-actions table is borderline inline-heavy but remains useful and appropriately placed, leaving minor organization gaps rather than a clean one-level-deep split. | 4 / 5 |
Total | 16 / 20 Passed |