convex-best-practices
Offers architectural advice and standardized patterns for building scalable applications on the Convex platform.
Install
mkdir -p .claude/skills/convex-best-practices && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2943" && unzip -o skill.zip -d .claude/skills/convex-best-practices && rm skill.zipInstalls to .claude/skills/convex-best-practices
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Guidelines for building production-ready Convex apps covering function organization, query patterns, validation, TypeScript usage, error handling, and the Zen of Convex design philosophyKey capabilities
- →Organize functions by domain
- →Implement argument and return validation
- →Optimize queries using indexes
- →Handle errors with ConvexError
- →Apply optimistic concurrency control
How it works
The skill provides patterns for Convex development, including schema-driven data modeling, reactive query design, and idempotent mutation strategies.
Inputs & outputs
When to use convex-best-practices
- →Structuring a new Convex backend
- →Optimizing database queries for performance
- →Implementing error handling for database writes
About this skill
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.
When not to use it
- →When the project does not use the Convex platform
- →When the user requires non-TypeScript backend logic
Prerequisites
Limitations
- →Strictly follows Convex-specific runtime constraints
- →Requires adherence to defined linting rules
How it compares
It provides specific architectural patterns and linting rules for Convex rather than general backend development advice.
Compared to similar skills
convex-best-practices side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| convex-best-practices (this skill) | 3 | 9mo | Review | Intermediate |
| bullmq-specialist | 25 | 10mo | No flags | Intermediate |
| agent-dev-backend-api | 3 | 9mo | No flags | Intermediate |
| convex-functions | 4 | 9mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by waynesutton
View all by waynesutton →You might also like
bullmq-specialist
davila7
BullMQ expert for Redis-backed job queues, background processing, and reliable async execution in Node.js/TypeScript applications. Use when: bullmq, bull queue, redis queue, background job, job queue.
agent-dev-backend-api
ruvnet
Agent skill for dev-backend-api - invoke with $agent-dev-backend-api
convex-functions
waynesutton
Writing queries, mutations, actions, and HTTP actions with proper argument validation, error handling, internal functions, and runtime considerations
supabase-known-pitfalls
jeremylongshore
Execute identify and avoid Supabase anti-patterns and common integration mistakes. Use when reviewing Supabase code for issues, onboarding new developers, or auditing existing Supabase integrations for best practices violations. Trigger with phrases like "supabase mistakes", "supabase anti-patterns", "supabase pitfalls", "supabase what not to do", "supabase code review".
convex-component-authoring
waynesutton
How to create, structure, and publish self-contained Convex components with proper isolation, exports, and dependency management
add-league
osrs-leagues
Add a new OSRS league season to the Discord bot. Use when: adding a league, creating a new league, new league season, new league type. Creates model, migrations, updates League type, config, and commands.