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 solid, executable CLI playbook — copy-paste commands, a documented connection state machine with polling/error recovery, and a proxy escape hatch with a full flags table. Its main defects are wasted content (a placeholder 'CloudFill Overview' section and padded intro sentences), dangling step references ('skip to Step 2' with no Step 2), inconsistent heading hierarchy, and an unresolved identity mismatch: the intro calls CloudFill a Dropbox-like storage service while every popular action is about PDF templates, and the docs URL (cloudfill.co) disagrees with the connection URL (cloudfill.io).
Suggestions
Delete or fill in the placeholder 'CloudFill Overview' section (Form/Field/Submission) and trim the intro's padding sentence — both are wasted tokens that don't instruct.
Fix the workflow's dangling references: either number the steps (1. connect, 2. search/run actions) so 'skip to Step 2' resolves, or reword to plain prose, and give the '1b' heading a matching '1a'.
Reconcile the skill's identity: the intro describes a Dropbox-like storage service but all popular actions are PDF-template operations, and cloudfill.co vs cloudfill.io conflict — align the description, docs URL, and examples with what the service actually does.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient (terse command blocks, a flags table, no library-comparison padding), but there is clear waste: the intro's tail ('It's used by individuals and businesses for document management and collaboration') is padding, the 'CloudFill Overview' section is a four-line placeholder ('**Form** / **Field** / **Submission** Use action names and parameters as needed.') that explains nothing, and the awkward 'Agent Types' aside adds little. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; not 4 because the placeholder section is pure wasted tokens. | 3 / 5 |
Actionability | Commands are concrete and copy-paste ready throughout: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.cloudfill.io/" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input \'{"key": "value"}\' --json', plus a full proxy-flags table. Minor gaps keep it below 5: 'membrane login --tenant --clientName=<agentType>' shows a --tenant flag with no value, and there is no end-to-end example running one of the popular actions (e.g. generate-pdf) with real input values. | 4 / 5 |
Workflow Clarity | The sequence is clear (install → login → connection ensure → poll for readiness → search actions → run → proxy fallback) and the connection section has genuine feedback loops: '--wait' long-polling, an explicit state machine (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), and 'After the user completes the action... poll again'. Not 5 because 'skip to **Step 2**' is referenced twice but no Step 2 (or Step 1) exists anywhere, and '#### 1b' implies an unlabeled 1a — dangling cross-references that break the flow. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the skill is a single well-sectioned page (Install / Authentication / Connecting / Searching / Popular actions / Proxy / Best practices) with a stable command vocabulary, which is an appropriate structure for a CLI-driven skill of this size. Not 5 due to organization gaps: 'Running actions' and 'Proxy requests' sit as h3 subsections under '## Popular actions' despite being general workflow topics, and the incoherent 'CloudFill Overview' placeholder section adds structure without navigation value. | 4 / 5 |
Total | 15 / 20 Passed |