schema-builder

Design and validate Convex database schemas with validators, indexes, and relationships.

3|Updated May 23, 2026
One-click install
npx skills add https://github.com/waynesutton/finder9 --skill schema-builder-waynesutton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-builder
Source: https://github.com/waynesutton/finder9/tree/main/.codex/skills/schema-builder
Command: npx skills add https://github.com/waynesutton/finder9 --skill schema-builder-waynesutton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex Schema Builder provides a structured approach to designing and generating Convex database schemas with proper validation, indexes, and relationships. It helps teams when creating schema.ts or modifying table definitions to maintain consistency and correctness.

Core Features & Use Cases

  • Define tables with typed fields, validators, and relations
  • Automatically generate index definitions for efficient queries
  • Enforce document-relational patterns and strong type safety across schemas

Quick Start

Create or update convex/schema.ts using the schema builder to define tables, relationships, and validators.

Frequently Asked Questions about schema-builder

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

FAQPage Schema
How do I design and validate a Convex database schema?

Designing and validating a Convex database schema involves creating a convex/schema.ts file where you use defineSchema and defineTable to structure tables, enforce v.* validators for fields, and set up index definitions for efficient queries.

What is the best way to add indexes and relationships to Convex tables?

The best way to add indexes and relationships to Convex tables is by using a structured schema builder that automatically generates index definitions and enforces document-relational patterns within your schema.ts file.

When do I need to use v.* validators in a Convex schema?

You need to use v.* validators in a Convex schema when defining typed fields in your schema.ts file to enforce strong type safety and ensure document validity before data is written to the database.

Can I use the schema builder to modify existing table definitions in a Convex project?

Yes, you can use the schema builder to modify existing table definitions in a Convex project by refining data models, adding new tables, and updating validation rules within your current schema.ts file.

Does defining tables with Convex schema builder enforce strong type safety across relationships?

Defining tables with the Convex schema builder enforces strong type safety across relationships by applying id references and document-relational patterns, ensuring consistency and correctness throughout your data models.