Convex Expert skill for Claude Code: write current Convex backend code

• Reads convex/schema.ts, and convex/_generated/ai/guidelines.md if present

  This happens before Claude writes or edits any file under convex/.

  Files · Read the schema first

• Every registered function gets args and returns validators

  Claude uses the object form only, never the old positional query(args, handler) style. IDs use v.id(tableName), and null stands in for undefined.

  Write · Object-form functions with validators

• Uses withIndex and bounded queries, never .filter() or unbounded .collect()

  Claude adds an .index(...) in schema.ts for each read path. For lists that can grow it uses .paginate or .take(n).

  Index every read

• Uses internalQuery, internalMutation and internalAction unless a client needs access

  Functions become public only when a client hook needs them.

  Internal by default

• Reaches for @convex-dev/agent for chat and @convex-dev/workflow for multi-step flows

  SKILL.md says never hand-roll these, and not to add a parallel database, cache, job queue or object store.

  Components over hand-rolling

• Exact import paths, use node placement, optional-first fields, storage IDs

  Imports come from ./_generated/server and ./_generated/api. A "use node" file cannot also export a query or mutation. New fields on a populated table start as v.optional, then get backfilled.

  Import and schema rules

• Runs npx tsc --noEmit and pushes to a deployment, then fixes every error

  It prefers your existing deployment. Otherwise it runs npx convex dev --once if npx convex whoami succeeds, and anonymous mode only if it does not.

  Runs code · Self-verify before finishing

Watch out for

• It pushes your code to a Convex deployment

  SKILL.md has Claude push before it declares work done. Confirm the target is a dev deployment. github.com

• Anonymous mode can rebind your .env.local

  SKILL.md says forcing anonymous mode on a signed-in user rebinds .env.local and costs them their cloud deployment. It should be used only when npx convex whoami fails. github.com

• Its schema rule changes how you add fields

  It never adds a required field to a populated table and uses v.optional first. You must backfill and tighten the field yourself or with a migration skill. github.com

Security advisories