Conciseness

The body is lean and states only Convex-specific, non-obvious rules ('Never call .filter() on a table query', 'a public reference there skips the auth checks', '"use node" only in files that export actions') with no padding or explanation of concepts Claude already knows, matching the 5 anchor's 'every token earns its place'.

Actionability

Every section provides complete, copy-paste-ready TypeScript covering the common cases (queries with withIndex, mutations with patch, internal scheduling, actions with runQuery/runMutation, ConvexError, thin wrappers), plus concrete method and mistake-to-fix tables, matching the 5 anchor.

Workflow Clarity

The decision flow is clear (pick type by what the handler touches, then method tables, then a checklist) and the final Checklist section gives explicit verification checkpoints, but since mutations are database operations there is no run-time validation loop (e.g., type-check the result with the Convex toolchain before finishing), leaving it at 4 rather than 5's explicit validate-fix-retry feedback.

Progressive Disclosure

Sections are well-organized with a one-level-deep Docs link list, but the ~270-line body inlines everything (the Common mistakes table, terminal-method reference, and extended examples) with no reference files to split into, which is good structure with minor organization gaps — the 4 anchor.

Specificity

The description lists multiple concrete actions — 'Writes Convex queries, mutations, actions, and internal functions', 'object form with args and returns validators', 'correct ctx usage, runtime boundaries, and error handling' — giving comprehensive coverage with no notable gaps, matching the 5 anchor rather than the 4 anchor's 'minor gaps in coverage'.

Completeness

It explicitly answers both what the skill does and when to use it, with a concrete 'Use when adding or changing anything in convex/*.ts that exports a function, or when deciding between query, mutation, and action' trigger clause, matching the 5 anchor exactly.

Trigger Term Quality

Good keyword coverage with natural terms users would say ('queries, mutations, actions', 'query, mutation, and action') plus the path trigger 'convex/*.ts', but a few natural synonyms are missing (e.g., cron, scheduled functions, database functions), so it sits at the 4 anchor rather than 5's comprehensive synonym coverage.

Distinctiveness Conflict Risk

It carves out a clear Convex-specific niche with a path-scoped trigger ('convex/*.ts that exports a function'), making conflict with other skills minimal and matching the 5 anchor's 'clear niche with distinct triggers'.