Content
61%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 delivers strong, copy-paste-ready Membrane CLI guidance with real feedback loops around connection states — its biggest strengths are actionability and structure. Its weaknesses are broken sequencing references (a never-defined 'Step 2' and an orphaned '1b' heading), padding (marketing opener, empty Overview list, duplicated discovery command), and a 'Popular actions' section that names no actions.
Suggestions
Fix the broken step references: either label the sections as Step 1 / Step 2 or rewrite 'skip to Step 2' as 'skip to Searching for actions', and renumber the orphaned '1b' heading to match a coherent scheme.
Cut the marketing opener and the content-free 'AddSearch Overview' bullet list, and deduplicate the action-discovery command (pick one invocation style — `membrane` vs `npx @membranehq/cli@latest`).
Make 'Popular actions' earn its title by listing 3-5 actual AddSearch action examples (e.g. search, index status, crawler setup) with sample `membrane action run` invocations, or fold the discovery instructions into the 'Searching for actions' section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient commands, but contains trimmable padding: the marketing opener "AddSearch is a hosted search solution for websites. It allows website owners to provide a better search experience", the content-free "AddSearch Overview" bullet list (Search/Result/Index/Configuration/Account), and a redundant repeat of the action-discovery command (once as `membrane action list`, once as `npx @membranehq/cli@latest action list`). Fits anchor 3 (mostly efficient but some unnecessary explanation); not 4 because there are several such sections, not just minor instances. | 3 / 5 |
Actionability | Concrete, executable commands throughout — install, login (including headless completion), connection ensure, polling with --wait, action run with --input JSON, and a proxy flags table. Fits anchor 4 (mostly executable, minor gaps) rather than 5 because the "Popular actions" section lists no actual AddSearch actions (only discovery instructions), and CLI invocation is inconsistent between `membrane` and `npx @membranehq/cli`. | 4 / 5 |
Workflow Clarity | A rough sequence exists (install → login → connect → poll → act) with genuinely good state-based feedback loops (poll until not BUILDING, re-poll after user completes auth, check the error field on CONFIGURATION_ERROR/SETUP_FAILED). However, "If the returned connection has state: READY, skip to Step 2" references a Step 2 that is never labeled anywhere, and the "1b" heading has no corresponding numbered step scheme — the sequence is present but its checkpoints and flow references are broken. Fits anchor 3; not 4 because dangling step references make the intended order impossible to follow as written. | 3 / 5 |
Progressive Disclosure | Single-file skill with no bundle files and no references to nonexistent files; sections are clearly headed (Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) and content is appropriately placed for a ~140-line skill. Fits anchor 4 (good structure, minor organization gaps) — the useless Overview bullet list and the reference-grade proxy flags table are the minor gaps; not 3 since nothing is buried or clearly misplaced for this skill size. | 4 / 5 |
Total | 14 / 20 Passed |