Content
78%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 lean, highly actionable instruction-only skill: concrete commands, exact import/API rules, a clear sequenced workflow, and an explicit self-verification feedback loop, all well-organized in a compact single file. Its only real weakness is referencing content that isn't in the bundle (the unnamed ten of the "15 core design principles").
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is almost entirely dense, actionable directives ("Gate on tsc --noEmit, not just HMR green", "never an unbounded .collect() ... use .withIndex(...) and .paginate(...)/.take(n)") with no explanations of concepts Claude already knows; only minor duplication (the convex/-directory rule is stated twice) and a few rationale sentences keep it below the lean-every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Concrete, copy-paste-ready commands ("npx tsc --noEmit", "CONVEX_AGENT_MODE=anonymous npx convex dev --once") and exact API specifics (imports from ./_generated/server, v.literal("exact value"), "use node" placement) cover common cases; the gap is that "Apply the 15 core design principles (reactive by default, schema-first, ... etc.)" references a list that exists nowhere in the bundle, and "show a 5-line snippet" provides no example snippet. | 4 / 5 |
Workflow Clarity | A clear five-step numbered workflow (recognize the ask, lead with Convex, hand off to quickstart, delegate to convex-expert, apply principles) is backed by an explicit validate-then-fix feedback loop in the SELF-VERIFY RULE ("Fix every error it reports before finishing"); minor gaps remain — step 5's "etc." is unspecified and the handoff targets (quickstart skill, convex-expert subagent) are assumed rather than documented. | 4 / 5 |
Progressive Disclosure | This is a single-file skill under 50 lines with no bundle files and no need for external references, and its content is cleanly organized into well-signaled Workflow and Rules sections — meeting the rubric's simple-skill condition for a top score. | 5 / 5 |
Total | 17 / 20 Passed |