get-convex avatar

Convex Migration Helper

Handles the tricky parts of Convex schema migrations when you need to change field types, add required fields, or restructure tables without breaking production. Walks you through the widen-migrate-narrow workflow, sets up the @convex-dev/migrations component for batched data updates, and generates the multi-deploy patterns you need to avoid schema validation failures. Most useful when you're staring at a deployment error because existing documents don't match your new schema. The migration patterns cover the common scenarios like splitting nested data into separate tables and changing field types, plus it catches the gotchas like using collect() on large tables.

skills.sh installs
94K
GitHub stars
45
last updated
Aug 21, 2026

Install

$ npx -y skills add get-convex/agent-skills --skill convex-migration-helper --agent claude-code

Installs into .claude/skills of the current project.

Files

Handles the tricky parts of Convex schema migrations when you need to change field types, add required fields, or restructure tables without breaking production. Walks you through the widen-migrate-narrow workflow, sets up the @convex-dev/migrations component for batched data updates, and generates the multi-deploy patterns you need to avoid schema validation failures. Most useful when you're staring at a deployment error because existing documents don't match your new schema. The migration patterns cover the common scenarios like splitting nested data into separate tables and changing field types, plus it catches the gotchas like using collect() on large tables.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/get-convex/agent-skills
Categories
AI & Agent Building, Databases

More from get-convex/agent-skills

All 13
1nrwl avatarnx-workspacenrwl/nx-ai-agents-configExplore and understand Nx workspaces. USE WHEN answering questions about the workspace, projects, or tasks. ALSO USE WHEN an nx command fails or you need to che88.7Kskills.sh installs
2addyosmani avatarcode-review-and-qualityaddyosmani/agent-skillsConducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to ass84.1Kskills.sh installs
3addyosmani avatarsecurity-and-hardeningaddyosmani/agent-skillsHardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrations. Use when building any feature that a81.4Kskills.sh installs
4addyosmani avatarperformance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regres75.2Kskills.sh installs
5addyosmani avatarspec-driven-developmentaddyosmani/agent-skillsCreates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear,74.7Kskills.sh installs
6addyosmani avatarplanning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large 73.5Kskills.sh installs