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.
This is a strong, highly actionable skill: all guidance is concrete, executable CLI commands covering setup, auth (including headless flows), connection lifecycle with state handling, action discovery, and a raw-API fallback. Its main weaknesses are the absence of any validation/confirmation step before destructive actions, and a small amount of introductory padding (the Chargify overview sections) that could be trimmed or moved out of the main file.
Suggestions
Add explicit validation guidance before destructive actions (Cancel Subscription, Delete Customer) — e.g. confirm the target record with a Get call and ask the user before executing, satisfying the workflow-clarity feedback-loop requirement.
Trim or relocate the 'Chargify Overview' entity list and the introductory 'what is Chargify' paragraph, which restate knowledge Claude already has.
Move the Popular actions table into a references file (e.g. references/actions.md) and keep a short pointer plus the few most common actions inline, improving progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-driven and mostly lean, with only minor over-explanation: the opening paragraph explaining what Chargify is ('a subscription billing and recurring revenue management platform... used by SaaS and subscription-based businesses'), the entity-taxonomy 'Chargify Overview' bullet list, and slightly padded best-practices prose. This matches anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') — the padding is real but a small fraction of the document, so it is above anchor 3. | 4 / 5 |
Actionability | Every section gives copy-paste-ready commands with concrete flags: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://chargify.com" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input {...} --json', plus a proxy options table. This matches anchor 5 ('fully executable; copy-paste ready commands; specific examples cover the common cases') — even edge cases like headless auth ('membrane login complete <code>') and polling with '--wait' are handled. | 5 / 5 |
Workflow Clarity | There is a clear sequence (install → login → connection ensure → poll states → search actions → run → proxy fallback) with state-based checkpoints ('READY', 'CLIENT_ACTION_REQUIRED', 'CONFIGURATION_ERROR') and a polling loop, which would merit 4–5. However, the skill supports destructive operations (Cancel Subscription, Delete Customer in the actions table) and contains no validation or confirmation guidance before running them, so per the rubric's cap ('missing validation/verification steps in workflows involving destructive or batch operations should cap workflow clarity at 3'), the score is capped at 3. | 3 / 5 |
Progressive Disclosure | The document is well-sectioned (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) and entirely self-contained — no bundle files exist, so there are no buried or nested references. This matches anchor 4 ('good structure; most content is appropriately placed; minor organization gaps'), falling short of 5 because the 20-row Popular actions table is inline reference material that would be more discoverable in a separate file in this ~160-line skill. | 4 / 5 |
Total | 16 / 20 Passed |