# Convex

> 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.

- Skill: `majiayu000/convex` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/convex`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/convex/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/convex

---


<objective>
Provide comprehensive Convex development guidance to avoid common mistakes and ensure code compiles on first try.
</objective>

<quick_reference>
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
</quick_reference>

<process>
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
</process>

<required_reading>
Always load: references/guide.md
</required_reading>