Content
88%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-structured CLI reference with exemplary validation and confirmation gating around destructive and bulk operations, and it correctly pushes editing detail out to a reference file. The two real weaknesses are a broken reference — EDITING-FLOW.md is cited but absent from the bundle — and modest redundancy between the Authentication and Drafts/Publishing sections and their inline counterparts.
Suggestions
Ship the missing EDITING-FLOW.md in the skill bundle (or update/remove the link) — the Editing Flow section currently dead-ends for any reader following it.
Move the Cloudflare Access / reverse-proxy auth flows and the long site-import flag prose into a dedicated reference file to keep SKILL.md a lean overview and lift progressive disclosure to anchor 5.
Deduplicate the `--draft`/`--published` guidance: keep it in one place (either the CRUD comments or the Drafts and Publishing section), and fold the conceptual auth ladder into the Quick Reference authentication block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by lean, copy-paste command blocks with terse inline comments, and the prose it does keep is genuinely non-obvious product behavior (auto-publish defaults, `--rev` tokens, scope errors, import exit codes). It misses anchor 5 due to minor duplication — the "Authentication" and "Quick Reference > Authentication" sections overlap, and the "Drafts and Publishing" section restates `--draft`/`--published` semantics already commented inline in the CRUD examples — though these are trimmable rather than padded. | 4 / 5 |
Actionability | Nearly every section is copy-paste-ready: exact `npx emdash ...` commands with realistic values (IDs, `--rev MToyMDI2...`, `--at 2026-03-01T09:00:00Z`), jq pipelines, and the common cases covered per command group. This matches the anchor-5 example of fully executable, specific commands with common-case coverage, and clearly exceeds anchor 4's "minor gaps" level. | 5 / 5 |
Workflow Clarity | Multi-step workflows are explicitly sequenced with strong validation checkpoints: site import runs analyze → review plan/digest → `--plan sha256:<hex> --confirm` → status/resume/receipt with documented exit codes and `receiptDigestValid: true`; content update requires `--rev` from a prior get; destructive ops are gated on a prior read ("Resolve the current target with a read command before a destructive or bulk mutation") and user confirmation of the plan. Feedback loops (resume after interruption, cancel/abandon) are present, satisfying the destructive/batch validation requirement rather than triggering the cap at 3. | 5 / 5 |
Progressive Disclosure | Structure is good: a two-category command overview up front, one section per command group, and detail correctly delegated to a clearly signaled one-level reference ("see [EDITING-FLOW.md](./EDITING-FLOW.md)"). It falls short of anchor 5 because the bundle contains no such file — the sole referenced path does not exist alongside SKILL.md — and the 260-line quick-reference monolith (Cloudflare Access flow, full site-import flag semantics) sits inline where a second reference file would fit; this places it noticeably above anchor 3's "references present but not clearly signaled" but below the clean overview-plus-references ideal. | 4 / 5 |
Total | 18 / 20 Passed |