migration-helper

Plan and execute Convex schema migrations with backfill strategies.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/tradewinds-center/rabbithole --skill migration-helper-tradewinds-center
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration-helper
Source: https://github.com/tradewinds-center/rabbithole/tree/main/.claude/plugins/convex/skills/migration-helper
Command: npx skills add https://github.com/tradewinds-center/rabbithole --skill migration-helper-tradewinds-center

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and execute Convex schema migrations safely, including adding fields, renaming fields, changing field types, and data backfills to preserve integrity.

Core Features & Use Cases

  • Migration planning and release-safe implementation guidance for Convex schemas.
  • Backfill and zero-downtime patterns to migrate data without service disruption.
  • Real-world scenarios: adding optional fields, splitting tables, and preserving existing data integrity during upgrades.

Quick Start

Provide a safe, zero-downtime migration plan for an existing Convex schema.

Frequently Asked Questions about migration-helper

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

FAQPage Schema
How do I execute a zero-downtime Convex schema migration without data loss?

To execute a zero-downtime Convex schema migration without data loss, you must use explicit migration code, backfill strategies, and safety checks. This approach maintains data integrity while allowing service continuity during schema upgrades.

What is the best way to split tables in a Convex project?

The best way to split tables in a Convex project is to plan the schema migration with explicit release-safe implementation guidance. This involves using backfill patterns to migrate data safely while preserving existing data integrity during the table separation.

How does a backfill strategy work when changing field types in Convex?

A backfill strategy for changing field types in Convex works by deploying explicit migration code to update existing records safely. It ensures zero-downtime by progressively updating data while maintaining data integrity across the schema change.

Do I need explicit migration code to add optional fields in Convex?

Yes, you need explicit migration code to add optional fields in Convex safely. While optional fields may not break existing queries, explicit code and safety checks ensure that backfill strategies maintain data integrity during the upgrade.

What are the limitations when renaming fields during a Convex migration?

When renaming fields during a Convex migration, limitations include potential service disruption if not handled with zero-downtime patterns. You must carefully manage backfill strategies and safety checks to prevent data loss and preserve existing data integrity.