convex-development

Apply Convex development best practices for backend architecture and optimization.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/phrazzld/claude-config --skill convex-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-development
Source: https://github.com/phrazzld/claude-config/tree/main/skills/convex-development
Command: npx skills add https://github.com/phrazzld/claude-config --skill convex-development

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

Provides guidance on Convex backend structure, architecture, and performance/cost optimization.

Core Features & Use Cases

  • Deep module pattern: Use convex/model/ with lightweight public API wrappers.
  • CQRS-like separation: Distinguish reactive reads from non-reactive endpoints.
  • Cost & performance: Emphasize indexing, pagination, and ergonomic queries.

Quick Start

Start by organizing code in convex/model/ and exposing thin wrappers in convex/*.ts.

Frequently Asked Questions about convex-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a Convex backend for performance and cost efficiency?

Organize Convex backends using the deep module pattern: place core logic in convex/model/ and expose lightweight public API wrappers in convex/*.ts. This separation improves maintainability, reduces query costs through efficient indexing and pagination, and supports both reactive reads and non-reactive endpoints.

What's the best way to optimize Convex queries and mutations?

Apply Convex best practices: use .withIndex() for indexed queries, paginate results to reduce data transfer, design schemas for common access patterns, and distinguish reactive reads from non-reactive mutations. These practices lower costs and improve backend robustness.

How do I implement vector search and embeddings in Convex?

Convex backends support embeddings and vector search patterns for semantic queries. Apply migration patterns and schema design practices to store embeddings efficiently, then use vector indexing and search techniques within your organized backend architecture.

What schema design and migration practices does Convex require?

Convex enforces schema design and migration patterns to maintain consistency. Commit convex/_generated files, follow functional requirements in code review, and plan migrations carefully to ensure secure, cost-efficient schema evolution across your backend.

Can I use Convex for code review and architecture discussions in my backend?

Yes. The Convex development framework covers architecture discussions, code review practices, and security guidance. It helps teams establish patterns for query optimization, schema design, and cost-efficient backend structure through best-practice enforcement.

Do I need to commit generated Convex files to version control?

Yes. Convex requires committing convex/_generated to maintain consistency across your backend. This ensures type safety, proper function registration, and reproducibility in your development and deployment workflows.