convex-migration-helper

Plan and execute Convex schema and data migrations using a widen-migrate-narrow workflow.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Atemndobs/ops-central --skill convex-migration-helper-atemndobs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migration-helper
Source: https://github.com/Atemndobs/ops-central/tree/main/.agents/skills/convex-migration-helper
Command: npx skills add https://github.com/Atemndobs/ops-central --skill convex-migration-helper-atemndobs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Plans and executes safe Convex schema and data migrations across apps to prevent downtime and data loss.

Core Features & Use Cases

  • Supports widening the schema, backfilling data, and zero-downtime deployments using the widen-migrate-narrow workflow.
  • Leverages the @convex-dev/migrations component for batched migrations, dry runs, status monitoring, and cross-app guardrails.
  • Applies to multi-app deployments, breaking changes, and data transformations that require coordinated updates.

Quick Start

Run the migration workflow defined in convex/migrations.ts and monitor progress with the migrations status tool.

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 schema migrations in Convex?

Backfill data in Convex during a schema migration by leveraging the @convex-dev/migrations component for batched data transformations, ensuring existing records safely conform to the new schema structure without interrupting app availability.

What is the widen-migrate-narrow workflow for database migrations?

The widen-migrate-narrow workflow is a migration pattern that first expands the schema to support both old and new formats, backfills existing data, and then narrows the schema to enforce the new structure, ensuring safe and progressive data transitions.

Can I run dry runs and monitor status for Convex data migrations?

Yes, you can run dry runs and monitor status for Convex data migrations using the @convex-dev/migrations component, which provides built-in guardrails to validate breaking schema changes and track batched migration progress across multi-app deployments.

How do I handle breaking schema changes across multiple Convex apps?

Handle breaking schema changes across multiple Convex apps by applying coordinated multi-app deployment guardrails, ensuring that data transformations and schema updates are synchronized safely to prevent data loss and downtime.

When should I use guardrails for Convex schema migrations?

Use guardrails for Convex schema migrations when you are applying breaking changes or executing large-scale backfill operations, as they enforce safe transition patterns and prevent data corruption during multi-app deployments.