Content
93%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.
An exemplarily lean, dense overview with executable scaffold code, a real capability contract table, and well-signaled one-level-deep references that all resolve to actual bundle files. The only notable gap is the absence of an explicit error-recovery/feedback loop in the testing workflow, which keeps workflow clarity at 4 rather than 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains no explanations of concepts Claude already knows; every sentence carries EmDash-specific contracts such as "Sandboxed runtime code can use Web APIs but not Node.js built-ins" and "decoded request/response bodies limited to 8 MiB". It is lean throughout and assumes competence, matching the score-5 anchor; there is no padding to trim as the score-4 anchor would require. | 5 / 5 |
Actionability | The scaffold block ("pnpm dlx @emdash-cms/plugin-cli init my-plugin") and the complete, runnable `src/plugin.ts` example are copy-paste ready, and specific API names (`ctx.settings`, `ctx.kv`, `createPluginTestHost()`, `host.http.respond()`) cover the common cases, matching the score-5 anchor. | 5 / 5 |
Workflow Clarity | Sections imply a clear sequence — choose format, scaffold, declare access, build routes/hooks/UI, then "Test the production boundary" with two concrete test-host factories and "Dispose every host after use". It falls short of the score-5 anchor because there is no explicit validate-fix-retry feedback loop (e.g., what to do when `pnpm run test` fails), but checkpoints are more present than absent, so it is above a 3. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a genuine overview: each section points to its one-level-deep reference ("Read [Hooks](./references/hooks.md)", "[Block Kit](./references/block-kit.md)"), all 12 referenced files exist in ./references/, and a consolidated References list aids navigation — a direct match for the score-5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |