db-convex

Guide Convex schema and data-access patterns for TypeScript projects.

2|Updated Jan 30, 2026

Search Tags:#typescript #workflow #schema #queries #mutations #actions #convex

Ready to run

npx skills add https://github.com/george11642/george-plugins --skill db-convex

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: db-convex
Source: https://github.com/george11642/george-plugins/tree/main/plugins/george-setup/skills/db-convex
Command: npx skills add https://github.com/george11642/george-plugins --skill db-convex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex schema and data-access patterns guide consistent development across Convex projects, reducing boilerplate and mistakes.

Core Features & Use Cases

Schema pattern guidance for defineTable, index, and searchIndex usage.
Clear examples of function types (query, mutation, action, httpAction).
Anti-pattern guidance to avoid common pitfalls and align with CLAUDE.md guidelines.

Quick Start

Define a Convex table with a string field and a nested object, then add an index and a searchIndex.

Frequently Asked Questions about db-convex

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

FAQPage Schema

How do I define a Convex schema with indexes and searchIndex in TypeScript?▼

To define a Convex schema, use defineTable with typed fields, then chain index and searchIndex methods for efficient querying. This ensures consistent data access patterns and proper runtime configurations across your TypeScript schema definitions.

What's the best way to structure Convex queries, mutations, and actions?▼

Structure Convex queries, mutations, and actions by using clear function type patterns for each: query for reactive data fetching, mutation for state changes, and action or httpAction for server-side logic. Consistent patterns reduce boilerplate and prevent common pitfalls.

When do I need to use Convex actions versus mutations?▼

Use Convex mutations for synchronous database state changes and actions for asynchronous operations requiring external API calls or multi-step logic. Actions run in a separate runtime environment and cannot directly read or write the database without calling internal queries or mutations.

How do I avoid common anti-patterns when designing Convex data models?▼

Avoid common Convex anti-patterns by following CLAUDE.md guidelines: always define indexes on frequently queried fields, use searchIndex for text search, enforce proper runtime configurations, and apply consistent defineTable patterns across all server functions.

Can I use Convex workflows to orchestrate multiple server actions?▼

Yes, Convex workflows let you orchestrate multiple server actions and mutations in a structured sequence. This helps manage complex operations by chaining actions together with consistent patterns and proper runtime configurations across your TypeScript project.

Why does my Convex query perform slowly without an index?▼

Convex queries without indexes scan entire tables, causing slow performance. Define indexes on frequently filtered fields using the index method in defineTable to optimize reactive query execution and ensure efficient data retrieval across your schema.