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 Membrane integration mechanics are genuinely well documented — executable commands, real state-handling feedback loops, and a sensible workflow order. Weaknesses are the near-total absence of Checkr-specific content (no actions, endpoints, or worked examples for the actual domain), duplicated/garbled sections, and dangling step references ('Step 2', '1b') that break workflow coherence.
Suggestions
Populate 'Popular actions' with real Checkr examples (e.g. create candidate, list packages, send invitation) including a worked `action run` invocation with sample `--input` JSON, instead of restating the generic discovery command.
Fix the broken workflow cross-references: either number the steps (1, 1b, 2, ...) consistently so 'skip to Step 2' resolves, or restructure as a simple linear checklist under 'Connecting to Checkr'.
Trim padded prose (URL-normalization explanation, 'fastest way to get a connection', the garbled 'Agent Types' sentence) and remove the duplicate action-list section; replace the malformed 'Checkr Overview' bullet list with a one-line-per-entity summary of Report, Candidate, Invitation, and Package.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command documentation without concept over-explaining, but contains several instances of padding: the URL-normalization explanation ('The URL is normalized to a domain and matched against known apps. If no app is found, one is created and a connector is built automatically'), a duplicated action-discovery section ('Searching for actions' and 'Popular actions' both show `action list --intent`), and a garbled filler sentence ('Those will be used to adjust tooling to be used best with your harness'). It sits between anchors 2 and 3, closer to 3, since the majority of lines are lean executable commands. | 3 / 5 |
Actionability | Concrete, executable commands throughout — `npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://checkr.com" --json`, `membrane action run <actionId> --connectionId=... --input '{...}'` plus a complete proxy flag table. The gap keeping it from 5: no worked Checkr-specific example at all — the 'Popular actions' section contains no actual actions (no create-candidate, run-background-check, or invitation examples), so common cases are not covered. | 4 / 5 |
Workflow Clarity | A clear install → login → connect → discover → run sequence with genuine validation loops (poll `BUILDING` until ready, handle `clientAction` states, check `error` field on failure). It falls short of 5 because the step references are incoherent: 'skip to **Step 2**' points to a step that doesn't exist, and '#### 1b. Wait for the connection' appears with no 1a — minor validation gaps and broken cross-references, matching anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so all content lives in a single ~140-line SKILL.md with clear section headers and an official-docs pointer. Structure is good and most content is appropriately placed; the inlined generic Membrane CLI lifecycle material (connection states, proxy flags) and the empty 'Popular actions' and malformed 'Checkr Overview' entity lists are minor organization gaps, matching anchor 4 rather than 3 (structure is clearly good) or 5 (over 50 lines with content that could be split out). | 4 / 5 |
Total | 15 / 20 Passed |