SKILL.md
Convex schema validator
Produces a convex/schema.ts that types every document, indexes every query path, and passes validation against the data already in the database. The one rule: every withIndex in a function needs a matching .index() here, named after its fields, queried in field order.
When to reach for this
- Creating a new table or adding a field to an existing one
- A query uses
.filter()and needs an index instead - Deciding whether to embed an object or link with
v.id - Modeling a document that comes in several shapes
npx convex devfails with a schema validation error
Schema skeleton
// convex/schema.ts
import { defineSchema, defineTable } from "convex/server";
import { v } from "convex/values";