Content
86%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 exemplary overview-style skill body: dense, EmDash-specific guidance with no filler, executable scaffold and test instructions, and a clean one-level reference architecture verified against the actual bundle. The only improvements are adding small inline code snippets for routes/MCP/admin UI workflows and making validation sequencing more explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no explanation of what a CMS, hook, or API is; every sentence carries EmDash-specific contracts (e.g., "Patch does not imply read", "decoded request/response bodies limited to 8 MiB"). The capability table rows each state a distinct grant with no padding. | 5 / 5 |
Actionability | The scaffold workflow is fully executable (copy-paste `pnpm dlx @emdash-cms/plugin-cli init my-plugin` plus a complete `src/plugin.ts` example), and the test section names concrete host functions. Minor gaps remain: routes, MCP tools, and admin UI sections give precise directive prose but no inline executable examples, deferring to references. | 4 / 5 |
Workflow Clarity | Sections follow a coherent lifecycle (choose format → scaffold → declare access → routes/hooks/UI → runner parity → test) with explicit decision guidance ("Use a sandboxed plugin unless...") and a dedicated test-boundary section distinguishing two test hosts. However, there is no explicit validate-then-proceed loop or error-recovery checkpoint inline, keeping it below a 5. | 4 / 5 |
Progressive Disclosure | A ~130-line overview with all 12 referenced files verified to exist, one level deep in references/ (only sibling cross-links, no nesting), each clearly signaled at the point of use ("Read [Hooks](./references/hooks.md)") plus a consolidated References index. Detail is appropriately offloaded — references total ~2300 lines while the body stays an overview. | 5 / 5 |
Total | 18 / 20 Passed |