Content
90%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 excellent reference-style skill: executable code, hard-to-recall limits and gotchas, and a mistakes table that doubles as error recovery guidance, all without padding. Its only structural trade-off is that the full validator and mistakes reference material is inlined in SKILL.md rather than split into reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious specifics Claude cannot be assumed to know ("At most 8192 items", "Reserved names: by_id and by_creation_time. Limits: 32 indexes per table, 16 fields per index", "Not v.bigint(), which is deprecated") and never pads with explanations of what Convex is. Every section is a compact table or code block where each token earns its place, matching the lean anchor-5 case. | 5 / 5 |
Actionability | Code is complete and executable throughout: a full defineSchema skeleton, a working withIndex query showing equality-prefix-then-range, search/vector index declarations, and return validators including _id/_creationTime. The Common mistakes table pairs each error with a concrete fix, covering the common cases in copy-paste-ready form. | 5 / 5 |
Workflow Clarity | The skill has a clear arc (when to use → skeleton → validators → optional/nullable → unions → indexes → relationships → mistakes → checklist) and validation checkpoints exist ("npx convex dev pushes without a schema validation error", the "v.optional, backfill, then require" migration pattern), so the database-operation cap does not apply. It is not anchor 5 because error recovery is distributed in tables and a checklist rather than an explicit validate→fix→retry loop. | 4 / 5 |
Progressive Disclosure | No bundle reference files exist, and the body is well-organized with clear section headers, a discriminated-unions cross-reference, and a Docs section of external links — good structure with most content appropriately placed. At ~240 lines, the validator reference table and Common mistakes table could plausibly live in separate reference files, which keeps it below the anchor-5 ideal of well-signaled one-level-deep references. | 4 / 5 |
Total | 18 / 20 Passed |