convex-schema-validator

Validate Convex schemas against defined models for typing and migration issues.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/NitzanSelwyn/MomentumTrackerAdmin --skill convex-schema-validator-nitzanselwyn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-schema-validator
Source: https://github.com/NitzanSelwyn/MomentumTrackerAdmin/tree/main/.claude/skills/Convex%20Schema%20Validator
Command: npx skills add https://github.com/NitzanSelwyn/MomentumTrackerAdmin --skill convex-schema-validator-nitzanselwyn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex Schema Validator provides a structured approach to defining and validating Convex database schemas with proper typing, index configuration, optional fields, unions, and migration strategies, reducing runtime errors and schema drift.

Core Features & Use Cases

  • Define and validate schemas for Convex applications to ensure type safety and consistent migrations.
  • Support for complex types including optional fields, unions, arrays, and objects, plus discriminated unions for polymorphic data.
  • Guidance and examples for common migration paths, index configurations, and data evolution across schema versions.

Quick Start

Install and configure the convex-schema-validator in your project and run a schema validation pass to generate a report.

Frequently Asked Questions about convex-schema-validator

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

FAQPage Schema
How do I validate a Convex schema to catch typing and migration issues early?

You validate a Convex schema by running a validation pass against your defined model to enforce strict type definitions and catch migration issues early. This ensures proper index configurations and reduces runtime errors.

Does Convex schema validation support complex types like optional fields and unions?

Convex schema validation does support complex types including optional fields, unions, arrays, and objects. It also handles discriminated unions for polymorphic data to ensure strict typing across your database schema.

What is the best way to manage Convex database migrations and index configurations?

The best way to manage Convex migrations and index configurations is by validating schemas against a defined model. This provides structured guidance for common migration paths and ensures index configurations remain consistent across schema versions.

Why does schema drift happen in Convex projects and how can I prevent it?

Schema drift in Convex projects happens when database structures diverge from application expectations over time. You prevent it by applying structured schema validation to enforce strict type definitions and consistent migration strategies.

Can I use strict type definitions for polymorphic data in a Convex schema?

You can use strict type definitions for polymorphic data in a Convex schema by leveraging discriminated unions. The validator enforces these strict types to maintain data consistency and prevent runtime type errors.