schema-builder

Generate Convex schemas with validators, indexes, and relationships.

Updated Aug 23, 2026

Search Tags:#validation #schema #indexes #type-safety #relationships #convex

Ready to run

npx skills add https://github.com/tomrford/dotfiles --skill schema-builder-tomrford

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: schema-builder
Source: https://github.com/tomrford/dotfiles/tree/main/.agents/skills/schema-builder
Command: npx skills add https://github.com/tomrford/dotfiles --skill schema-builder-tomrford

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex schema design is error-prone and repetitive; this skill provides a structured approach to creating and validating Convex schemas with proper relationships and indexes.

Core Features & Use Cases

Generate well-structured Convex schemas with validators and relationships.
Add or optimize indexes to support common queries and maintain performance.
Enforce type safety and consistent schema design across projects.
Use when creating a new convex/schema.ts or modifying table definitions to ensure correctness and maintainability.

Quick Start

Create a new convex/schema.ts using the template to define tables, relations, and indexes, then run the validator to ensure correctness.

Frequently Asked Questions about schema-builder

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

FAQPage Schema

How do I create a Convex schema with validation and indexes?▼

To create a Convex schema with validation and indexes, define your tables, relations, and indexes in a convex/schema.ts file using the schema template, then run the validator to ensure correctness. This enforces strong type-safe validators and optimized queries.

What's the best way to model relationships in a Convex schema?▼

Modeling relationships in a Convex schema involves using the provided schema template to define clear relationship structures alongside table definitions. This structured approach ensures consistent relationship modeling and maintains type safety across your Convex project.

How do I optimize Convex indexes for common queries?▼

Optimizing Convex indexes for common queries requires applying proper indexing strategies when defining table fields in your schema. Adding or adjusting indexes supports frequent query patterns and maintains performance as your application scales.

When do I need to update table definitions in my convex/schema.ts file?▼

You need to update table definitions in your convex/schema.ts file when modifying existing database structures to ensure correctness and maintainability. This includes adding or optimizing indexes and enforcing strong type-safe validators across your Convex project.

Can I enforce type safety and consistent schema design across multiple Convex projects?▼

Yes, you can enforce type safety and consistent schema design across multiple Convex projects by applying a structured schema template. This ensures correct validation, proper indexing strategies, and clear relationship modeling for every new or updated table definition.