Agent skill
convex-migration-helper
Plan and implement safe Convex schema and data migrations, especially when changing existing fields, relationships, or required data.
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?
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?