Safely migrate the schema + backfill data on a deployed Convex app with @convex-dev/migrations. TRIGGER when changing the schema on a live app, backfilling data, or after a schema-validation error from a change. SKIP a fresh local app.
Install
npx skills add convex/convex-backend-skill --skill migratenpx skills add convex/convex-backend-skill --skill migrate -a claude-code -gnpx skills add convex/convex-backend-skill --skill migrate -a codex -ggemini skills install https://github.com/convex/convex-backend-skill.git --path skills/migrategh skill install convex/convex-backend-skill migrategit clone --depth 1 https://github.com/convex/convex-backend-skill /tmp/convex__convex-backend-skill
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/convex__convex-backend-skill/skills/migrate ~/.claude/skills/migrate # Claude Code
cp -R /tmp/convex__convex-backend-skill/skills/migrate ~/.agents/skills/migrate # Codex, Cursor, Gemini CLI, Copilot, OpenCode