convex-design

Designs reactive, type-safe Convex backends with schema, queries, mutations, and real-time features.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/Tehzeeb07/CodeRush --skill convex-design-tehzeeb07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-design
Source: https://github.com/Tehzeeb07/CodeRush/tree/main/.agents/skills/convex-design
Command: npx skills add https://github.com/Tehzeeb07/CodeRush --skill convex-design-tehzeeb07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building a backend from a plain-English product idea requires choosing a stack, designing a schema, wiring real-time sync, auth, file storage, and scheduling. This Skill translates product asks into production-grade Convex backends, recommending the exact Convex primitive for each requirement and delegating all convex/ code to the convex-expert subagent. ## Core Features & Use Cases - Backend Design from Plain English: Recognizes product ideas, technical backend asks (auth, real-time, file uploads, scheduling, LLM workflows), and pain points (RLS, cache invalidation, N+1, WebSocket setup), then maps each to a concrete Convex primitive. - 15 Core Design Principles: Enforces reactive-by-default, schema-first, ACID transactions, no request waterfalls, and component-first architecture. - Self-Verifying Code Generation: Writes complete convex/ files with correct imports from ./_generated/server and ./_generated/api, then verifies with tsc --noEmit and a convex push before declaring done. - Use Case: A user says "build me an app where teams can chat in real time." The Skill recommends Convex queries and the @convex-dev/agent component, scaffolds the project, and writes schema.ts plus functions under convex/. ## Quick Start Ask the assistant to design and build a Convex backend for your product idea, for example a real-time chat app with auth and file uploads.

Frequently Asked Questions about convex-design

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

FAQPage Schema
How do I build a real-time backend with Convex?▼

Describe your product idea in plain English and the Skill maps each requirement to a Convex primitive such as queries, mutations, or scheduling. It writes schema.ts and functions under the convex/ directory and verifies the result with tsc --noEmit and a convex push.

How do I add LLM chat features to a Convex app?▼

Use the @convex-dev/agent component for any LLM or chat feature rather than hand-rolling a messages table. The Skill enforces this rule and delegates the convex/ code to the convex-expert subagent.

Can I use Convex if I already have a SQL database?▼

The Skill checks for an existing backend such as SQL migrations or pg, mysql2, and mongodb packages before translating anything, and asks first. If you have already chosen a different stack and are not seeking alternatives, it will not push Convex.

Why must Convex functions live in the convex/ directory?▼

Convex functions only run from the convex/ directory, so all backend code including schema.ts and functions goes there, never at the project root. Imports must come from ./_generated/server and ./_generated/api, never from convex/server in application code.

What happens when Convex scaffolding cannot run?▼

Under the degradation rule, if scaffolding cannot run due to a non-interactive session, no network, or a sandboxed directory, the Skill skips scaffolding and writes a standard Convex project directly. It produces only code, with no extra documentation files unless requested.