Content
72%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-organized CLI reference with copy-paste commands throughout. Its main gaps are missing validation guidance for destructive operations and a referenced EDITING-FLOW.md file that does not exist in the bundle.
Suggestions
Add validation/verification checkpoints around destructive and batch operations (e.g. confirm a collection is empty or list contents before 'schema delete --force', and verify a 'content delete' succeeded with a follow-up 'content get').
Provide the missing EDITING-FLOW.md bundle file referenced at the end of the body, or remove the dangling link and inline the essential editing-flow notes.
Consider moving the per-command flag reference into a separate reference file so SKILL.md stays a lean overview with one-level-deep links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean command reference with minimal padding; explanatory prose like 'The CLI is designed for agents. Create and update auto-publish by default...' is genuinely domain-specific rather than recycled knowledge, though a few sentences could be trimmed. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready `npx emdash ...` commands across every command group with flags and common cases shown, e.g. 'npx emdash content create posts --data ...' and pipe-to-jq examples. | 5 / 5 |
Workflow Clarity | Commands are grouped and the auth-resolution order is sequenced (1-4), but destructive/batch operations like 'schema delete --force', 'content delete', and 'remove-field' have no validation or verification checkpoints, capping this dimension at 3. | 3 / 5 |
Progressive Disclosure | Section structure is good, but the one offloaded reference ('see EDITING-FLOW.md') points to a file that is not present in the bundle, and the bulk of the command reference is inlined in SKILL.md rather than split out. | 3 / 5 |
Total | 15 / 20 Passed |