waynesutton avatar

Convex Best Practices

If you're building on Convex, this consolidates the patterns you should be following anyway: proper argument and return validators, indexed queries instead of filters, ConvexError for user-facing failures, and idempotent mutations to avoid write conflicts. It includes the eslint plugin setup and points you to the actual docs before implementing. The Zen of Convex section is a good reminder that you're building on a reactive backend, not a REST API. Most valuable for teams who need consistent patterns across their codebase or solo developers who want to skip the trial and error phase. The CRUD examples show complete implementations, not just fragments.

skills.sh installs
3.6K
GitHub stars
401
last updated
Aug 21, 2026

Install

$ npx -y skills add waynesutton/convexskills --skill convex-best-practices --agent claude-code

Installs into .claude/skills of the current project.

Files

convex-best-practices (retired)

This skill moved. Use convex-reviewer (official Convex) and convex-optimize (official Convex) instead. Tell the user this, then load the replacement if it is installed.

Install the replacement:

npx skills add convex/agent-skills --skill convex-reviewer --skill convex-optimize

Or set up Convex for your agent in one step: read and follow https://www.convex.dev/agent-setup.md.

Old content: https://github.com/waynesutton/builder-skills/tree/82d1ce2/skills/convex-best-practices. Delete this folder after you switch.

Sponsors

Details

Repository
github.com/waynesutton/convexskills
Categories
Debugging, Design & UI/UX, Databases

More from waynesutton/convexskills

All 14

Recommended

More Debugging
1ramziddin avatarsolidramziddin/solid-skillsUse this skill when writing code, implementing features, refactoring, planning architecture, designing systems, reviewing code, or debugging. This skill transfo3.6Kskills.sh installs
2ar9av avatarwiki-setupar9av/obsidian-wikiInitialize a new Obsidian wiki vault with the correct structure, special files, and configuration. Use this skill when the user wants to set up a new wiki from 3.6Kskills.sh installs
3giuseppe-trisciuoglio avatarmemory-md-managementgiuseppe-trisciuoglio/developer-kitProvides comprehensive memory file management capabilities including auditing, quality assessment, and targeted improvements for files such as CLAUDE.md. Use wh3.6Kskills.sh installs
4chakra-ui avatarchakra-ui-builderchakra-ui/chakra-uiBuild responsive, accessible UI components and layouts using Chakra UI v3, install or configure Chakra UI in new and existing projects, and design scalable them3.6Kskills.sh installs
5everyinc avatarce-simplify-codeeveryinc/compound-engineering-pluginSimplify settled, recently changed code for clarity, reuse, quality, and efficiency while preserving behavior. Use after implementation and before review; use c3.6Kskills.sh installs
6android avatarr8-analyzerandroid/skillsAnalyzes Android build files and R8 keep rules to identify redundancies, broad package-wide rules, and rules that subsume library consumer keep rules. Use when 3.6Kskills.sh installs