Content
85%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 highly actionable, well-guarded CLI reference whose destructive and bulk workflows are exemplary (analyze/confirm digests, exit codes, resume paths). Its two weaknesses are a broken reference to a missing EDITING-FLOW.md and duplicated authentication coverage that wastes tokens.
Suggestions
Fix the dangling reference: either include EDITING-FLOW.md in the bundle or remove/inline the pointer in the "Editing Flow" section.
Merge the two Authentication sections ("## Authentication" and "### Authentication" under Quick Reference) into one to remove redundancy and save tokens.
Tighten the long site-import prose paragraph into a short bulleted list of exit codes, scope requirements, and safety rules for faster scanning.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with commented, executable command blocks and assumes Claude's competence without explaining known concepts. It falls short of 5 due to redundancy: authentication is covered twice ("## Authentication" and "### Authentication" under Quick Reference) and some prose in the site import section could be tightened. | 4 / 5 |
Actionability | Nearly every section is copy-paste-ready `npx emdash` commands covering the common cases — list/get/create/update/delete with concrete flags, media upload with real arguments, jq piping for JSON output, and the two-phase site import with digests and follow-up commands. Only two illustrative lines use ellipsis placeholders, which is acceptable. | 5 / 5 |
Workflow Clarity | Risky and bulk operations have explicit validation and feedback loops: "Resolve the current target with a read command before a destructive or bulk mutation", schema inspection before delete, the site import sequence of `--analyze` -> reviewed plan digest -> `--confirm`, documented exit codes (2 for blockers, 1 for failed imports), resume/cancel/abandon recovery, and `receiptDigestValid: true` as the completion checkpoint. | 5 / 5 |
Progressive Disclosure | The body is well organized into clear sections and appropriately inlines command reference, but its single external reference — "see [EDITING-FLOW.md](./EDITING-FLOW.md)" — points to a file that is not present in the bundle, breaking navigation. That dangling reference keeps it at 3 rather than 4. | 3 / 5 |
Total | 17 / 20 Passed |