Convex Best Practices

What it does

A rules-and-patterns skill for building apps on Convex, the reactive backend platform.

• Function organization: domain files (users.ts, tasks.ts), public vs internalMutation
• Validation: always declare both args and returns validators
• Query performance: schema indexes plus withIndex instead of filter
• Error handling: ConvexError with structured code/message for clients
• Write-conflict avoidance (OCC): idempotent mutations, patch without a prior read, Promise.all for independent updates
• Safety rails: never runs npx convex deploy or git commands unless told to
• Points to @convex-dev/eslint-plugin and its four build-time rules, plus official docs and llms.txt

Who it's for

• Developers shipping Convex + TypeScript backends
• Teams tired of AI-generated Convex code missing return validators or abusing filter
• Anyone chasing down Convex write-conflict (error #1) issues

Examples

1. "Scaffold CRUD for the tasks table" → list/create/update/remove with return validators and a by_user index
2. "This mutation keeps hitting write conflicts" → refactored to an idempotent early-return + direct patch
3. "This query is slow" → replaces filter with a schema index and withIndex

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/waynesutton/convexskills/HEAD/skills/convex-best-practices/SKILL.md

What I want: (describe your task here)

Install the skill I found on Claude Skill Mart.
Copy the skills/convex-best-practices folder from the GitHub repo waynesutton/convexskills into my ~/.claude/skills/convex-best-practices/.
When it's done, tell me in one line what this skill can do.