Agent skill

convex-migration-helper

Plan and implement safe Convex schema and data migrations, especially when changing existing fields, relationships, or required data.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/convex-migration-helper

Metadata

Additional technical details for this skill

author
agentforge
source
get-convex/convex-agent-plugins@f104efb49a787a1ef4a6c84df496d58800ce334a

SKILL.md

Convex Migration Helper

Use this when a schema change affects existing rows or when data shape must be transformed.

Migration defaults

  • Prefer additive changes first.
  • Add required fields as optional, backfill, then tighten.
  • Use internal functions for migration work.
  • Keep the app running during the migration whenever possible.

When this skill is needed

  • Required fields are being introduced.
  • Field types are changing.
  • Nested data is being split into relational tables.
  • Existing indexes or lookup paths are changing in ways that require backfills.

What to check

  • Is a dual-read or dual-write period needed?
  • Can the migration run in batches?
  • Does the schema need a temporary compatibility state?
  • Are there existing functions that assume the old shape?

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results