convex-migration-helper

Plan and execute Convex schema migrations safely with multi-deploy workflows and data transformation.

get-convex ↓ 89k

Claude Code

View source ↗

What it does

Adding new required fields to existing tables
Changing field types or structure
Splitting or merging tables
Renaming or deleting fields
Migrating from nested to relational data
Greenfield schema with no existing data in production or dev
Adding optional fields that do not need backfilling

Requirements & configuration

Adding optional fields that do not need backfilling
Questions about Convex schema design without a migration need
7. Update schema to require the new format only
batching via recursive scheduling internally. Crons require manual cleanup
[ ] Update schema to require new format only

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Plan and execute Convex schema migrations safely with multi-deploy workflows and data transformation.

Source

Repository: https://github.com/get-convex/agent-skills

convex-migration-helper FAQ

What does the convex-migration-helper skill do?

Plans Convex schema and data migrations with widen-migrate-narrow and @convex-dev/migrations. Use for breaking schema changes, backfills, table reshaping, or zero-downtime rollouts. Adding new required fields to existing tables Changing field types or structure

What does convex-migration-helper require?

Adding optional fields that do not need backfilling Questions about Convex schema design without a migration need 7. Update schema to require the new format only batching via recursive scheduling internally. Crons require manual cleanup [ ] Update schema to require new format only

How do I install convex-migration-helper?

Run: npx -y skills add https://github.com/get-convex/agent-skills --skill convex-migration-helper --agent claude-code — the source lives at github.com/get-convex/agent-skills.

Maintain convex-migration-helper?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![convex-migration-helper on getagentictools](https://getagentictools.com/badge/skills/get-convex-agent-skills-convex-migration-helper.svg)](https://getagentictools.com/skills/get-convex-agent-skills-convex-migration-helper?ref=badge)

npx agentictools info skills/get-convex-agent-skills-convex-migration-helper

The second line is the CLI lookup for this page — handy in READMEs and docs.