convex-migration-helper

Name: convex-migration-helper
Availability: InStock
Author: openclaw

Plan Convex schema migrations using widen-migrate-narrow and @convex-dev/migrations.

9.3k|1.4k|Updated Jan 3, 2026

Search Tags:#migrations #pattern #zero-downtime #convex #backfill #data-migration #schema-change

Ready to run

npx skills add https://github.com/openclaw/clawhub --skill convex-migration-helper-openclaw

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: convex-migration-helper
Source: https://github.com/openclaw/clawhub/tree/main/.agents/skills/convex-migration-helper
Command: npx skills add https://github.com/openclaw/clawhub --skill convex-migration-helper-openclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Safely migrate Convex schemas and data when making breaking changes, ensuring existing data remains intact and deployments avoid downtime.

Core Features & Use Cases

Provides a safe, repeatable migration workflow using the widen-migrate-narrow pattern.
Covers backfills, table reshaping, and zero-downtime rollouts across Convex deployments.
Includes references and patterns to guide teams through common migration scenarios.

Quick Start

Outline the schema change, plan the data transitions, and execute a migration with widening, migrating, then narrowing the schema.

Frequently Asked Questions about convex-migration-helper

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

FAQPage Schema

How do I perform a zero-downtime Convex schema migration?▼

Zero-downtime Convex schema migration uses the widen-migrate-narrow pattern to transition data safely. It enforces dual-write and dual-read strategies to keep deployments intact while applying breaking schema changes.

What is the widen-migrate-narrow pattern for data migrations?▼

The widen-migrate-narrow pattern is a structured workflow for safe data migration. You first widen the schema to accept both old and new shapes, migrate existing data via backfill, then narrow the schema to enforce the new structure.

How do I backfill data in Convex after a table reshaping?▼

To backfill data in Convex after table reshaping, use the @convex-dev/migrations package to execute a planned data transition. This ensures existing records remain intact during restructuring without causing deployment downtime.

Does the @convex-dev/migrations package support validation and dry runs?▼

The @convex-dev/migrations package supports a structured workflow with validation and dry runs for Convex migrations. This allows you to verify data transitions and breaking schema changes before executing a full zero-downtime rollout.

What is the best way to handle breaking schema changes in Convex?▼

The best way to handle breaking schema changes in Convex is applying an online migration pattern. Use the widen-migrate-narrow strategy to transition safely, ensuring existing data remains intact and deployments avoid downtime.