get-convex/agent-skills1 file
Convex Migrate
Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.
Specification
- Skill ID
- get-convex/agent-skills/convex-migrate
- Publisher
- get-convex
- Repository
- agent-skills
- Installs
- 380
- Files
- 1
- Synced
- Sep 16, 2026
How to use it
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
get-convex/agent-skills/convex-migrateInstalls these files- SKILL.md
What this skill tells the agent
<!-- 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
- Make the new field optional first (so deploy doesn't reject existing rows).
- Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
- Run the migration; verify all rows are valid.
- 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.