Content
67%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 a well-structured, actionable guide to the Membrane/GatherContent CLI workflow with concrete commands, a state-machine-driven connection flow, and clear section navigation. Its weaknesses are a padded marketing intro, minor redundancy in the action-discovery sections, and placeholder-heavy examples without concrete resolved values.
Suggestions
Remove or compress the opening marketing paragraph ("GatherContent is a content operations platform...") since it explains context Claude can infer; lead with the integration mechanics instead.
Consolidate the overlapping "Searching for actions" and "Popular actions" sections, both of which describe `membrane action list --intent`, into one discovery section.
Add one fully resolved end-to-end example (a real connectionId and intent) showing how to parse the `--json` output and feed it into `membrane action run`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient commands and flags, but it includes an unnecessary marketing-style intro paragraph ("content operations platform that helps marketing teams manage and streamline...") and duplicated coverage of action discovery across the "Searching for actions" and "Popular actions" sections, fitting the score-3 anchor of mostly efficient with some unnecessary explanation. | 3 / 5 |
Actionability | The skill provides many concrete, copy-paste-ready commands (install, login, connection ensure, action run with --input JSON, a full request flags table), but uses unresolved placeholders (CONNECTION_ID, QUERY, <actionId>) and gives no concrete example of parsing --json output, matching the score-4 anchor of mostly executable guidance with minor gaps. | 4 / 5 |
Workflow Clarity | The connect-to-ready flow is a clear sequence with explicit checkpoints (READY, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) and a feedback loop (poll, inspect state, act, re-poll), but the top-level progression relies on headers and references an unlabeled "Step 2", a minor validation gap that fits the score-4 anchor. | 4 / 5 |
Progressive Disclosure | With no bundle files present, the single SKILL.md is well-organized into navigable sections (Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) and has no nested or buried references, matching the score-4 anchor of good structure with minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |