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 is a solid, command-driven CLI guide with good actionability and clean sectioning. Its main weaknesses are an unnecessary intro explaining Lazada, a broken "Step 2" reference, and missing validation checkpoints for destructive/batch Lazada operations.
Suggestions
Remove or shrink the intro paragraph that explains what Lazada is and lists countries; Claude already knows this and it costs tokens.
Add explicit validation steps before running destructive or batch actions (e.g., verify connection state is READY and dry-run/confirm before order, payment, or return mutations) to lift workflow clarity above the cap of 3.
Fix the dangling "skip to Step 2" reference by labeling the action-search/run section as Step 2 or rewording the pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight commands, but the opening paragraph explains what Lazada is ("a popular Southeast Asian e-commerce platform, similar to Amazon or eBay") with a country list that Claude already knows, and phrases like "so you can focus on the integration logic rather than auth plumbing" add padding. | 3 / 5 |
Actionability | It provides concrete, copy-paste-ready commands for every main workflow (install, login, connection ensure, action list/run, request proxy) plus a flags table; minor gaps remain in placeholder substitution (CONNECTION_ID, <actionId>) and how to form the --intent "QUERY" string. | 4 / 5 |
Workflow Clarity | A clear install→auth→connect→poll→search→run sequence exists with state-based branching, but it lacks validation/verification checkpoints for destructive Lazada operations (orders, payments, returns) and the "skip to Step 2" reference points to no labeled Step 2, so it is capped at 3. | 3 / 5 |
Progressive Disclosure | Content is well-organized into clear sections (Overview, Working with Lazada, Best practices) with no nested or buried references, and since no bundle files exist everything is appropriately inline; minor gaps are the inlined entity list and proxy flag table that could live in references. | 4 / 5 |
Total | 14 / 20 Passed |