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 content is a highly actionable CLI guide with concrete commands and a well-validated connection workflow, weakened only by a redundant intro/duplicate section and broken step-numbering labels. It is a strong, copy-paste-ready skill body.
Suggestions
Remove or trim the opening 'Demandware, now Salesforce Commerce Cloud, is a cloud-based platform...' paragraph since Claude already knows the platform.
Delete the redundant 'Popular actions' section that repeats the `action list` command already shown under 'Searching for actions'.
Fix the broken step references: replace 'skip to Step 2' with a real '## Step 2' anchor and relabel '#### 1b' into the numbered sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is efficient concrete commands, but the intro ('Demandware, now Salesforce Commerce Cloud, is a cloud-based platform for e-commerce...') over-explains a platform Claude already knows, and the 'Popular actions' section duplicates the `action list` command already shown under 'Searching for actions', matching 'mostly efficient but includes some unnecessary explanation'. | 3 / 5 |
Actionability | The body is fully executable: copy-paste commands for install (`npm install -g @membranehq/cli@latest`), login, `connection ensure`, `action run` with `--input` JSON, `membrane request`, plus a complete proxy-flags table, covering the common cases per the 'fully executable; copy-paste ready' anchor. | 5 / 5 |
Workflow Clarity | There is a clear install→auth→connect→search→run sequence with validation checkpoints (polling connection state, branching on READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), but the step labelling is broken ('skip to Step 2' with no Step 2, and a lone '#### 1b'), fitting 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The single-file skill is organized into clear, well-signaled sections (Overview, Authentication, Connecting, Searching, Running, Proxy, Best practices) with no nested references and no bundle files to misroute, fitting 'good structure; most content is appropriately placed'; it is over 50 lines so the simple-skill 5 does not quite apply. | 4 / 5 |
Total | 16 / 20 Passed |