convex-migration-helper

Plan and execute Convex schema migrations with batched online updates.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/ScriptKitKat/TamaGoosie --skill convex-migration-helper-scriptkitkat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migration-helper
Source: https://github.com/ScriptKitKat/TamaGoosie/tree/main/convex/.agents/skills/convex-migration-helper
Command: npx skills add https://github.com/ScriptKitKat/TamaGoosie --skill convex-migration-helper-scriptkitkat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Plan and execute safe Convex schema and data migrations using the widen-migrate-narrow workflow and the @convex-dev/migrations component. This skill helps teams respond to deployment issues, backfill existing documents, and perform field changes, table splits/merges, and zero-downtime strategies.

Core Features & Use Cases

  • Plan and coordinate breaking changes with a multi-deploy workflow that widens the schema, migrates data, and narrows the schema.
  • Manage online migrations with batched updates, real-time validation, and rollback readiness using the migrations component.
  • Backfill, transform, and migrate data across Convex tables while keeping services available.

Quick Start

Describe your desired migration and run the migrations tooling to begin a safe, batched update.

Frequently Asked Questions about convex-migration-helper

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

FAQPage Schema
How do I execute zero-downtime Convex schema migrations without breaking production?

Backfill existing Convex documents during online migrations by leveraging the @convex-dev/migrations component. It coordinates batched updates with real-time validation checks, allowing you to safely transform and backfill data across tables without downtime.

What is the widen-migrate-narrow workflow for evolving database schemas?

The widen-migrate-narrow workflow is a multi-deploy strategy for evolving database schemas safely. You first widen the schema to accept both old and new formats, migrate existing data to the new structure, and finally narrow the schema to enforce the new validation rules.

How do I backfill data across Convex tables while keeping services online?

Backfill existing Convex documents during online migrations by leveraging the @convex-dev/migrations component. It coordinates batched updates with real-time validation checks, allowing you to safely transform and backfill data across tables without downtime.

What's the best way to handle failing schema validation in a Convex deployment?

Handle failing Convex schema validation by planning breaking changes with a multi-deploy workflow that widens the schema, migrates data, and narrows the schema. This approach resolves validation failures while maintaining rollback readiness.

Can I perform table splits and field changes safely during Convex data migrations?

Perform Convex table splits, merges, and field changes safely by coordinating batched, online migrations with validation checks and rollback safety. This ensures data integrity throughout the transformation process.