Convex Expert

If you're writing anything under a `convex/` directory, this agent is worth running first. It's built around the failure modes generic Claude keeps hitting in Convex: missing `args` and `returns` validators, unbounded `.collect()` calls on growing tables, `.filter()` used where a `withIndex` belongs, and the wrong import source for `query`/`mutation` versus `api`/`internal`, which fails the deploy outright. It enforces object-form function syntax, defaults to internal functions unless a client hook needs them, and routes LLM features to `@convex-dev/agent` instead of hand-rolled loops. The workflow ends with a real `convex dev` push, so you find out it compiles before you call it done. The rules are dense and opinionated, which is the point, though a few (like the anonymous-deployment fallback) assume you know how Convex's CLI auth works.

skills.sh installs: 41.4K
GitHub stars: 69
last updated: Oct 26, 2026

View on GitHub

Install

$ npx -y skills add convex/agent-skills --skill convex-expert --agent claude-code

Installs into .claude/skills of the current project.

Files

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.