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.
A well-structured, actionable CLI integration guide with executable commands and a sensible connection workflow. Its main weakness is conciseness — an unnecessary introductory paragraph and a few padded asides — plus a dangling 'Step 2' reference that breaks the workflow's internal navigation.
Suggestions
Trim the opening marketing paragraph and 'auth plumbing' asides; assume Claude knows what a shipping platform is and start directly with the integration mechanics.
Fix the dangling 'Step 2' reference by adding a labeled '## Step 2' header or rewording the cross-references so the connection workflow is internally navigable.
Add one fully-worked end-to-end example (e.g. connect → request-rates → create-shipment) with real substituted values to lift actionability from concrete-but-templated to copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient command-oriented sections, but the opening marketing-style paragraph ('Easyship is a shipping platform that helps e-commerce businesses streamline...') and phrases like 'so you can focus on the integration logic rather than auth plumbing' are unnecessary padding Claude does not need. | 3 / 5 |
Actionability | Provides concrete, executable commands throughout (npm install, membrane login, connection ensure, action list/run, request) with a populated actions table, though placeholders like <actionId> and CONNECTION_ID and the lack of a fully-worked end-to-end example leave minor gaps. | 4 / 5 |
Workflow Clarity | Clear install → login → connect → poll-until-ready → search → run sequence with state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and a poll-again feedback loop, though the dangling 'Step 2' reference (no matching header) and '#### 1b' labeling create a minor sequencing gap. | 4 / 5 |
Progressive Disclosure | Well-organized into clear sections (Overview, Working with Easyship, Popular actions, Best practices) in a single file with no bundle references; the inline Popular actions table is sizable but reasonably placed, leaving only minor organization gaps. | 4 / 5 |
Total | 15 / 20 Passed |