Content
75%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 intentionally minimal router skill that is exemplary on token efficiency and honest about deferring to version-matched bundled docs, but the deferral leaves the body non-executable for actual eve work: no quick-start snippet, no guide-selection mapping, and a reference file that restates the body instead of extending it.
Suggestions
Inline one minimal executable quick-start (e.g., the directory layout produced by `npx eve init <agent-name>` or a two-line agent-instructions file) so the lowest-scoring dimension, actionability, can stand on the body alone when the docs are unavailable.
Add a short task-to-guide mapping under the source-of-truth section (e.g., 'agent instructions → docs/instructions.md; evals → docs/evals.md') so 'read the relevant guide there first' is unambiguous instead of requiring Claude to infer it from the docs index.
Differentiate references/source-of-truth.md from the body — it currently repeats the same path and commands verbatim; either move the repo-local handoff-boundary detail there exclusively or fold it into the body and repurpose the file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~25-line body is lean with zero padding: it spends its tokens only on framework-specific facts Claude cannot know ("eve is a filesystem-first framework… an agent is a directory on disk") and exact navigation targets. It matches the anchor-5 'every token earns its place' example; there is nothing to trim and no generic-concept explanation. | 5 / 5 |
Actionability | Setup and navigation are concrete ("node_modules/eve/docs/README.md", "npm install eve", "npx eve init <agent-name>"), but the body's core task — creating, editing, or debugging eve code — is entirely delegated to external docs, so key execution details are missing from the skill itself. This matches anchor 3 ('some concrete guidance but incomplete… missing key details') rather than 4, whose minor-gap profile would require the body itself to cover the common cases. | 3 / 5 |
Workflow Clarity | The flow is clear and ordered — read the bundled docs first, install/scaffold if eve is missing, read the relevant guide before writing any code — with an explicit pre-code gate. It is below 5 because "read the relevant guide there first" is ambiguous: there is no task-to-guide mapping telling Claude which document matches instructions vs. tools vs. evals work, a minor gap matching anchor 4. | 4 / 5 |
Progressive Disclosure | The body is well-organized under clear sections and its single reference, "references/source-of-truth.md", is a real, clearly signaled, one-level-deep file — satisfying most of anchor 5. It scores 4 rather than 5 because that reference duplicates the body nearly verbatim (same doc path, same two commands), so the split adds navigation without adding content — a minor organization gap. | 4 / 5 |
Total | 16 / 20 Passed |