M
mongodb-migration-expert
About mongodb-migration-expert
A skill for planning safe MongoDB schema changes and migrations, aimed at developers working with evolving collections and large datasets. It emphasizes staged, backwards-compatible updates, batched backfills, and query-aligned indexes.
Key features
- 01Plan additive, backwards-compatible changes
- 02Backfill data in batches
- 03Design indexes around query patterns
- 04Keep migration scripts idempotent
- 05Validate index use with explain
Use cases
- 01Plan a forward-only schema migration
- 02Update collections used by multiple tenants
- 03Add indexes for common filters and sorts
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/mongodb-migration-expertin Claude Code to confirm it loaded.
Bundled filesplugin.json
Details
From the project READMEMongoDB Migration Expert
Design schema changes and migrations that are safe, indexed, and backwards compatible.
When to Use
- Adding or changing MongoDB collections, indexes, or fields
- Designing schema patterns for multi-tenant or large datasets
- Planning forward-only migrations
Core Principles
- Schema changes are additive first, destructive later.
- Backfill data in batches; avoid locking large collections.
- Indexes must match query patterns.
- Keep migrations idempotent and observable.
Migration Workflow
- Add new fields with defaults or nullable values.
- Deploy code that handles both old and new fields.
- Backfill data (scripted batches).
- Add or adjust indexes after backfill if needed.
- Remove legacy fields in a later release.
Indexing
- Add compound indexes for common filters and sorts.
- Avoid over-indexing; each index slows writes.
- Validate index usage with
explain.
Multi-tenant Pattern (if applicable)
- Include
tenantIdon documents. - Compound indexes should start with
tenantId.
Checklist
- Backwards compatible reads and writes
- Idempotent scripts
- Indexes created with safe options
- Roll-forward plan documented
Comments
Markdown supported