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 content is a well-structured, actionable guide to driving the ASIN Data API through the Membrane CLI, with a clear state-driven connection workflow and copy-paste-ready commands. Its main weakness is conciseness — background prose and an inline field taxonomy add tokens Claude does not strictly need.
Suggestions
Trim the introductory paragraph about who uses the API and use cases (market analysis, competitive research); Claude does not need the pitch.
Move the nested ASIN data-field taxonomy (Title, Brand, UPC, Listing Health, etc.) into a references/ file and link to it from the overview to keep SKILL.md lean.
Add one concrete end-to-end example, e.g. looking up a product by ASIN with a real action name and input, so the generic membrane commands connect to an actual ASIN use case.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but the opening paragraph ('used by e-commerce businesses, researchers, and developers... market analysis, competitive research...') is background padding Claude does not need, and some prose could be tightened. | 3 / 5 |
Actionability | It provides concrete, executable commands throughout (npm install, membrane login, connection ensure, action list/run, request with a flags table), with only minor gaps such as placeholder CONNECTION_ID/actionId values and no concrete example of a real ASIN query. | 4 / 5 |
Workflow Clarity | The connection flow is clearly sequenced with state-based checkpoints (READY, BUILDING, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) and a poll-again feedback loop, though step numbering is slightly loose ('skip to Step 2' without a clean enumerated Step 1/2). | 4 / 5 |
Progressive Disclosure | The body is well-organized into clear sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with no bundle files; the inline data-field taxonomy is the one block that could justify a separate reference file. | 4 / 5 |
Total | 15 / 20 Passed |