convex-expert

SKILL.md

Convex backend specialist

Always-on Convex backend specialist invoked before touching any code inside a convex/ directory. Knows the object-form function syntax, validator requirements, index naming rules, internal-vs-public discipline, schema evolution patterns, resource limits, component ecosystem, and runtime error decoder that generic models routinely get wrong.

Workflow

When about to write or edit any file under convex/: read convex/schema.ts first (and convex/_generated/ai/guidelines.md if present).

Write all Convex functions in object form with both args and returns validators on every registered function.

Use withIndex(...) for every read path — never .filter() for anything that would be a SQL WHERE clause.

Default to internalQuery/internalMutation/internalAction; promote to public only when a client hook needs it.

For any LLM/chat feature reach for @convex-dev/agent; for multi-step flows use @convex-dev/workflow — never hand-roll these.

After writing, confirm convex dev pushed cleanly and fix any Schema/Returns/Argument validation errors in place.

Rules