Content
75%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 provides concrete, executable Membrane CLI guidance covering installation, authentication (including headless fallback), connection setup with state-based polling and error handling, action discovery, and a proxy fallback, all in a well-organized single file. The main defects are a dangling 'Step 2' cross-reference, an official-docs link pointing to the wrong product (Rackspace Cloud Files), and light marketing padding.
Suggestions
Fix the dangling 'skip to Step 2' reference by numbering the workflow steps explicitly, and add a validation checkpoint after running an action (e.g. check the output field for errors before reporting success).
Correct the 'Official docs' link: rackspace.com/cloud/cloud-files is a different product from the cloudfiles.io sales platform the body documents.
Trim the marketing-style overview sentence and move the proxy flag table / clientAction state details into a references file so SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-focused with little concept explanation Claude already knows, matching anchor 4 ('Efficient; minor instances of over-explanation that could be trimmed'). Padding is present but limited: 'It's used by sales and marketing professionals to improve their sales process and content effectiveness' and the 'This is the fastest way to get a connection' sentence. Not 5 because the marketing-style overview sentences and the empty entity list ('File / File Content / File Metadata / Folder / Account / Shared Link' followed only by 'Use action names and parameters as needed') spend tokens without instructing anything. | 4 / 5 |
Actionability | The body is largely copy-paste executable: 'npm install -g @membranehq/cli@latest', 'membrane connection ensure "https://www.cloudfiles.io/" --json', 'membrane action run <actionId> --connectionId=CONNECTION_ID --input {...} --json', plus a complete proxy flag table. Matches anchor 4 ('Mostly executable guidance; concrete code or commands with minor gaps'). Not 5 because 'membrane login --tenant --clientName=<agentType>' leaves --tenant without a value, and the 'Official docs: https://www.rackspace.com/cloud/cloud-files' link points to Rackspace Cloud Files, a different product from the cloudfiles.io sales platform the body describes. | 4 / 5 |
Workflow Clarity | A clear sequence runs install → authenticate (with headless fallback) → connect → poll connection state → discover actions → run/proxy, with state-based branching ('READY', 'CLIENT_ACTION_REQUIRED' with its clientAction fields, 'CONFIGURATION_ERROR'/'SETUP_FAILED') acting as explicit checkpoints, matching anchor 4 ('Clear sequence with most checkpoints present; minor validation gaps'). Not 5 because 'skip to Step 2' references a Step 2 that does not exist (sections are unnumbered), and there is no verification step after running an action. | 4 / 5 |
Progressive Disclosure | The skill is a single well-sectioned SKILL.md with no bundle directories and no references to any external files, so nothing is nested or mislinked, matching anchor 4 ('Good structure; most content is appropriately placed; minor organization gaps'). Not 5 because at ~144 lines the connection-state machine and the proxy options table are detailed reference material that could live in a separate file to keep SKILL.md a lean overview. | 4 / 5 |
Total | 16 / 20 Passed |