SKILL DETAIL
convex-migrate
get-convex/agent-skills/convex-migrate
This skill guides you through changing a deployed schema without breaking existing data. Start by making new fields optional so the deploy doesn't reject existing rows. Then install @convex-dev/migrations and write a migration to backfill or transform existing rows. Run the migration, verify all rows are valid, and then tighten the validator (make the field required). Key rules include: never tighten a validator before the backfill completes, as it rejects existing rows and breaks the live app; always add new fields as optional first, migrate, then require; and verify row counts before and after.
Installation
npx skills add https://github.com/get-convex/agent-skills --skill convex-migrate
스킬 파일
SKILL.md
최근 동기화 · 2026. 8. 29.
SKILL.md›
---
name: convex-migrate
description: "Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations."
---
<!-- GENERATED from convex-agents content/capabilities/migrate.json — do not edit by hand. -->
# Migrate the schema / data on a live app
Change a deployed schema without breaking existing data: stage the schema change, install @convex-dev/migrations, write a backfill that makes old rows valid, run it, and verify before tightening the validator.
## Workflow
1. Make the new field optional first (so deploy doesn't reject existing rows).
2. Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
3. Run the migration; verify all rows are valid.
4. Tighten the validator (make the field required) once the backfill is complete.
## Rules
- Never tighten a validator before the backfill completes — it rejects existing rows and breaks the live app.
- Add new fields as optional first, migrate, then require.
- Verify row counts before and after.