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.
A well-engineered skill body: concrete gotchas, executable API examples, and a clean workflow that pushes detail into four substantial reference files one level deep. The only improvements are trimming the doubled reference listing and adding an explicit troubleshooting checkpoint to the run-and-verify step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and earns its tokens: five concrete gotchas, a file-structure map, and an API cheat sheet with no generic Astro/programming filler. It is not a 5 because there is minor redundancy — the four reference files are described twice (inline in the Workflow steps and again in the Reference Documents table) — and the intro sentence about what EmDash is could be one clause shorter. | 4 / 5 |
Actionability | Guidance is copy-paste ready: exact import paths ('emdash/ui', 'emdash/ui/comments'), executable query snippets (getEmDashCollection with limit/cursor/orderBy), concrete commands ('pnpm dev'), and gotchas stated as wrong-vs-right pairs ('Writing <img src={post.data.featured_image} /> renders [object Object]'). This matches anchor 5 — specific examples cover the common cases — rather than anchor 4, which allows missing key details. | 5 / 5 |
Workflow Clarity | A clear six-step sequence (configure → schema → pages → site features → seed → run and verify) with a final verification step that states expected behavior (migrations on first request, seed application, admin URL). It is not a 5 because there are no explicit error-recovery checkpoints (e.g., what to check when a page renders empty, echoing gotcha #3's silent empty results); it is above a 3 because a verify step with expected outcomes is present and no destructive/batch operation lacks validation. | 4 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview and all detail lives one level deep in four real, substantial reference files (234–540 lines each, verified present), each clearly signaled in the workflow with what it covers. This matches anchor 5's 'well-signaled one-level-deep references; content appropriately split; easy navigation' — no nesting and no reference-worthy content inlined. | 5 / 5 |
Total | 18 / 20 Passed |