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 body is highly actionable with concrete CLI commands and good connection-state handling, but loses points for an unnecessary intro explanation of LinkedIn Ads and a lack of validation guidance around its destructive delete actions.
Suggestions
Trim the opening paragraph that defines LinkedIn Ads and the 'rather than auth plumbing' marketing phrasing — Claude already knows the platform.
Add a validation/confirmation step before destructive actions, e.g. 'Before running delete-* actions, confirm the entity is in DRAFT state with a get-* call and verify the ID with the user'.
Consider moving the 20-row Popular actions table into a separate reference file and linking it, keeping only the most common entries inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient command reference, but the opening paragraph explaining what LinkedIn Ads is ('LinkedIn Ads is a platform for businesses to advertise to professionals...') and soft marketing lines ('focus on the integration logic rather than auth plumbing') restate concepts Claude already knows. | 3 / 5 |
Actionability | It provides copy-paste-ready, executable commands for every common case — 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "..."', 'membrane action run <actionId> ...', 'membrane request CONNECTION_ID /path' — plus a full action-key table. | 5 / 5 |
Workflow Clarity | The connection flow is well sequenced with state-based polling checkpoints (READY / BUILDING / CLIENT_ACTION_REQUIRED), but the skill exposes destructive operations (Delete Campaign Group/Campaign/Creative) with no validation or verification step before running them, capping this dimension at 3. | 3 / 5 |
Progressive Disclosure | Structure is clear with well-organized sections (Overview, Working with LinkedIn Ads, Popular actions, Best practices) and no nested references; the only minor gap is the 20-row action table and proxy-flag table being inlined rather than split into a reference file. | 4 / 5 |
Total | 15 / 20 Passed |