Content
63%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 genuinely actionable CLI integration guide with a clear workflow and validation loop, but it opens with unnecessary concept explanation and inlines a large actions catalog that would benefit from a separate reference file. Conciseness and progressive disclosure are the main weaknesses.
Suggestions
Delete or compress the opening paragraph explaining what Instagram Messenger is; Claude already knows this and it costs context tokens.
Move the 'Popular actions' table and proxy flag reference into a separate references file (e.g. actions.md) and link to it from the body to improve progressive disclosure.
Fix the step numbering inconsistency (references to 'Step 2' with no clearly labeled Step 2) and add one runnable example with a real parameter payload for `membrane action run`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete CLI commands, but the opening paragraph ('Instagram Messenger is a direct messaging platform integrated within the Instagram app...') explains a concept Claude already knows, and a few prose passages could be trimmed. | 3 / 5 |
Actionability | Provides concrete, copy-paste-ready commands for install, login, connection, action search/run, and proxy requests plus a flags table; minor gaps remain where placeholders like CONNECTION_ID need substitution and action parameters lack examples. | 4 / 5 |
Workflow Clarity | Clear install → authenticate → connect → search → run sequence with an explicit state-polling feedback loop (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and re-poll guidance; minor gaps include the slightly inconsistent step numbering ('skip to Step 2' without a clearly labeled Step 2). | 4 / 5 |
Progressive Disclosure | No bundle files exist and the body is well-sectioned, but the 18-row 'Popular actions' table and the proxy flag reference are inlined content that would navigate better as a separate reference file, and there are no one-level-deep references for deeper material. | 3 / 5 |
Total | 14 / 20 Passed |