convex-migrate
Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.
How do I install this agent skill?
npx skills add https://github.com/get-convex/agent-skills --skill convex-migrateIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides instructions and a workflow for migrating database schemas and backfilling data in Convex applications. It references the official @convex-dev/migrations package, which is a legitimate library for the platform, and adheres to standard safe practices for data migration. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/get-convex/agent-skills/convex-migrate">View convex-migrate on skillZs</a>