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 — concrete CLI commands, a complete actions table, and proxy guidance make it immediately usable — with a solid connection-state feedback loop. Its weaknesses are the marketing-fluff intro and bare feature list, the dangling 'Step 2' reference, and the absence of any validation/confirmation guidance for destructive delete operations.
Suggestions
Cut the 'Active Trail is an email marketing automation platform...' paragraph and the 'Active Trail Overview' feature bullet list — Claude doesn't need this background to operate the API (conciseness, currently score 3).
Add explicit verification before destructive actions, e.g. 'Before delete-contact/delete-mailing-list/delete-group, run the corresponding get action and confirm the target with the user' (workflow_clarity, currently capped at 3 by the missing-validation rule).
Fix the dangling 'skip to **Step 2**' references by labeling the Searching/Running sections as numbered steps, and consider moving the popular-actions table into a references file for a leaner SKILL.md (progressive_disclosure, currently score 4).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk of the body is efficient — commands, flag tables, and an actions table with no padding — but it opens with explanations Claude doesn't need: 'Active Trail is an email marketing automation platform... It's used by marketing teams and small business owners to engage with customers and grow their business' plus a bare feature bullet list ('Contacts', 'Campaigns', 'Reports'...) that adds no actionable guidance. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened'); it is not anchor 2 because the padding is confined to two short sections rather than being pervasive. | 3 / 5 |
Actionability | The guidance is fully executable: copy-paste-ready CLI commands for install ('npm install -g @membranehq/cli@latest'), login, connection setup ('membrane connection ensure "https://activetrail.com/" --json'), action search/run with JSON input examples, a proxy options flag table, and a 19-row actions table with exact keys covering the common cases (list/get/create/update/delete for contacts, lists, campaigns, groups). This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | The setup-to-execution sequence is present with a genuine polling feedback loop for connection states (BUILDING → CLIENT_ACTION_REQUIRED → poll again after user action), but it has validation gaps: the text says 'skip to **Step 2**' yet no Step 2 is ever labeled, CONFIGURATION_ERROR handling is just 'check the error field', and the destructive actions in the table (delete-contact, delete-mailing-list, delete-group) have no verification or confirmation guidance. Per the rubric's cap for destructive/batch operations without validation, workflow clarity cannot exceed 3. | 3 / 5 |
Progressive Disclosure | The skill has no bundle files, and the single body is well-organized with clear section headers (Install, Authentication, Connecting, Searching, Popular actions, Running, Proxy, Best practices) placing content appropriately; only the popular-actions table and proxy flag reference approach the size that could live in a separate file. This fits anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps') — not anchor 5 since at ~165 lines it exceeds the simple-skill threshold and could split the actions/proxy reference material into a references file. | 4 / 5 |
Total | 15 / 20 Passed |