Content
90%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 an excellent lean CLI reference: fully executable commands, well-grouped by task, with an explicit safety checkpoint for the only risky (cart-changing) operation. The two improvements are framing the Cloudflare/session-import sections as error-recovery paths and promoting section titles to real markdown headers.
Suggestions
Convert section titles to markdown headers (e.g. '## Quick start (Foodora)', '## Orders') so sections render and navigate correctly.
Frame the Cloudflare/browser-login/session-import sections as an explicit fallback flow, e.g. 'If login fails due to bot protection: 1) retry with --browser, 2) import session from Chrome', to add a validation feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean command reference with zero explanation of concepts Claude already knows; every line is a usable command or an actionable note ('Use --config /tmp/ordercli.json for testing', 'Confirm before any reorder'), matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Commands are copy-paste ready with concrete flags and placeholders (--password-stdin, --browser-profile, --address-id <id>), and the examples cover the common cases: login, listing orders, watching status, history, reorder, and session import. | 5 / 5 |
Workflow Clarity | Quick start provides a clear ordered sequence (countries -> config -> login -> orders -> history), and the one cart-changing operation has an explicit checkpoint (preview vs. --confirm plus 'Confirm before any reorder or cart-changing action'), so the destructive-operation cap does not apply; it falls short of 5 because login/session failure recovery is presented as alternatives rather than an explicit validate-and-retry loop. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and content appropriately stays in one flat file; however, section titles ('Quick start (Foodora)', 'Orders', 'Reorder...') lack markdown '##' headers, so they render as plain text instead of navigable sections — a minor organization gap that keeps it below 5. | 4 / 5 |
Total | 18 / 20 Passed |