CO

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

Installs 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 philosophy
186 charsno explicit “when” trigger
Intermediate

Key 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

You give it
Convex function or schema definition
You get back
Refactored code following best practices

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

@convex-dev/eslint-plugin

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.

SkillInstallsUpdatedSafetyDifficulty
convex-best-practices (this skill)39moReviewIntermediate
bullmq-specialist2510moNo flagsIntermediate
agent-dev-backend-api39moNo flagsIntermediate
convex-functions49moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry