# Convex Migration Helper

> Plan and implement safe Convex schema and data migrations, especially when changing existing fields, relationships, or required data.

- Skill: `majiayu000/convex-migration-helper` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/convex-migration-helper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/convex-migration-helper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/convex-migration-helper

---


# Convex Migration Helper

Use this when a schema change affects existing rows or when data shape must be transformed.

## Migration defaults

- Prefer additive changes first.
- Add required fields as optional, backfill, then tighten.
- Use internal functions for migration work.
- Keep the app running during the migration whenever possible.

## When this skill is needed

- Required fields are being introduced.
- Field types are changing.
- Nested data is being split into relational tables.
- Existing indexes or lookup paths are changing in ways that require backfills.

## What to check

- Is a dual-read or dual-write period needed?
- Can the migration run in batches?
- Does the schema need a temporary compatibility state?
- Are there existing functions that assume the old shape?