Content
92%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 skill body: lean, directive, and free of padding, with a task-classification-driven reference loading scheme that is one level deep and fully backed by existing files. The build order is explicit with a real validation checklist as the final checkpoint; the only minor gap is that the body itself contains little copy-paste code, deferring scaffolds to references/examples.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~75-line body is dense directive bullets with zero concept explanations — nothing teaches what React, Effector, or routing is; every line issues a library-specific instruction ('Initialize controls with setHistory before expecting route activation', 'Prefer declarative Effector links (sample, attach) over imperative glue code'). This matches the score-5 anchor 'Lean and efficient; assumes Claude's competence; every token earns its place'. | 5 / 5 |
Actionability | Guidance is concrete with exact API call shapes — 'router.registerRoute(...)', 'createRouter({ routes })', 'createRoutesView({ otherwise })', and a near-executable SSR expression 'allSettled(router.setHistory, { params: historyAdapter(createMemoryHistory(...)) })' — and copy-paste scaffolds are delegated to references/examples.md. Per the rubric's instruction-only allowance the missing inline code is not penalized, but most bullets remain directives rather than copy-paste-ready examples, so it sits between the score-4 and score-5 anchors rather than clearly matching the 'fully executable, copy-paste ready' anchor. | 4 / 5 |
Workflow Clarity | The workflow is a clear five-step sequence (classify task → load only required references → resolve source of truth → build in explicit dependency order → output contract), with an explicit validation checkpoint ('End with references/checklist.md before final output') backed by a real 59-line checklist file, plus error-recovery guidance ('If docs and code differ, follow code behavior and note mismatch briefly') and a dedicated 'debug' task category. This matches the score-5 anchor 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'; routing work is not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is a pure orchestrator: it keeps the overview inline and conditionally routes to 11 one-level-deep reference files keyed to task type ('Add references/react-web.md for any React integration task', 'Add references/paths-dsl.md when working with route path syntax'). All 11 referenced files exist in references/ and none nest further references. This matches the score-5 anchor 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'. | 5 / 5 |
Total | 19 / 20 Passed |