convex - SKILL.md Agent Skill

name: convex description: Convex backend development patterns, validators, indexes, actions, queries, mutations, file storage, scheduling, React hooks, and components. Use when writing Convex code, debugging Convex issues, or planning Convex architecture.

Provide comprehensive Convex development guidance to avoid common mistakes and ensure code compiles on first try. Key rules (full details in references/guide.md):

Functions: Import from ./_generated/server, use query({ args, handler }) syntax Indexes: Never use .filter() - use .withIndex(). Never define by_creation_time index Actions: Add "use node"; at top, never use ctx.db - use ctx.runQuery/ctx.runMutation Scheduler: Auth does NOT propagate - use internal functions React: Never call hooks conditionally - use "skip" pattern

1. Read `references/guide.md` for comprehensive Convex patterns 2. Apply patterns to the specific task 3. Verify against the checklist in section 18 of the guide Always load: references/guide.md