Content
57%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 Membrane CLI commands and a useful action catalog, and the connection workflow is well-sequenced with state checkpoints. Its weaknesses are mild marketing padding, missing validation for batch/destructive actions, and a monolithic structure with no file splitting.
Suggestions
Trim the promotional opening ('Drip is an e-commerce CRM designed to help businesses personalize marketing automation...') and the redundant 'Drip Overview' tree to tighten token efficiency.
Add an explicit verification/confirmation step before running batch or destructive actions (e.g., confirm count, review a dry-run, and check the response status), so the workflow can exceed the batch-cap of 3.
Move the full Popular actions table and the proxy request flag reference into a separate reference file (e.g. references/actions.md) and link to it from SKILL.md, keeping the main skill a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with dense command examples, but includes unnecessary marketing framing ('Drip is an e-commerce CRM designed to help businesses personalize marketing automation') and a redundant 'Drip Overview' tree that restates entities, fitting 'mostly efficient but includes some unnecessary explanation or could be tightened'. | 3 / 5 |
Actionability | It provides concrete, executable CLI commands throughout (membrane connection ensure, action list, action run, request) with real flags and a 20-row action table, but uses unsubstituted placeholders (CONNECTION_ID, <actionId>, <id>) and gives no example input payloads, matching 'mostly executable guidance; concrete code with minor gaps' rather than fully copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | The connection flow has a clear state-driven sequence with checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and a poll-after-action feedback loop, but running actions — including batch and destructive ones (create-or-update-subscribers-batch, unsubscribe-subscribers-batch) — has no validation or verification step, which caps workflow clarity at 3 per the batch-operation rule. | 3 / 5 |
Progressive Disclosure | The skill is well-organized with section headers but is a single ~190-line file with no bundle references, inlining the full Popular actions table and proxy flag reference that could live in separate files; since it exceeds the 50-line simple-skill exception, this fits 'some structure but content that should be separate is inline'. | 3 / 5 |
Total | 13 / 20 Passed |