convex-schema-validator

Validate Convex database schemas for typing, indexes, and migrations.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/EricJamesCrow/smartpockets --skill convex-schema-validator-ericjamescrow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-schema-validator
Source: https://github.com/EricJamesCrow/smartpockets/tree/main/.claude/skills/convex-schema-validator
Command: npx skills add https://github.com/EricJamesCrow/smartpockets --skill convex-schema-validator-ericjamescrow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures precise, type-safe Convex database schemas with correct index configurations and clear migration strategies, reducing drift and deployment risk.

Core Features & Use Cases

  • Define schemas with strong typing, optional fields, and unions.
  • Validate complex types, discriminated unions, indexes, and migrations.
  • Apply schema validation across projects to ensure deployment readiness.

Quick Start

Run convex-schema-validator against your schema.ts to verify typing, indexes, and migration readiness.

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 database schema in TypeScript?

Yes, discriminated unions and optional fields are validated by checking your schema.ts file against strict TypeScript typing rules. The validator scopes tables and relationships to ensure complex types are correctly configured for deployment.

What's the best way to check Convex indexes and migrations before deploying?

The best way to check Convex indexes and migrations is to apply schema validation across your project. This verifies index configurations and clear migration strategies, ensuring deployment readiness and reducing drift risk.

Does this schema validation work with complex types and relationships?

Yes, discriminated unions and optional fields are validated by checking your schema.ts file against strict TypeScript typing rules. The validator scopes tables and relationships to ensure complex types are correctly configured for deployment.

Why do I need to validate database schemas before deployment?

Validating database schemas before deployment ensures precise, type-safe configurations with correct indexes and clear migration strategies. This prevents schema drift and minimizes deployment risks across your project environments.