About

Imported from shipshitdev/skills (skills/mongodb-migration-expert/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill mongodb-migration-expert. Copyright stays with the author.

MongoDB Migration Expert

Name: mongodb-migration-expert
Author: shipshitdev

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 tenantId on documents.
Compound indexes should start with tenantId.

Checklist

Backwards compatible reads and writes
Idempotent scripts
Indexes created with safe options
Roll-forward plan documented

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-mongodb-migration-expert/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-mongodb-migration-expert.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-mongodb-migration-expert",
  "kind": "skill",
  "name": "mongodb-migration-expert",
  "description": "Database schema design, indexing, and migration guidance for MongoDB-based applications. Use when adding or changing MongoDB collections, indexes, or fields, designing schema for multi-tenant or large datasets, or planning forward-only migrations.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "mongodb",
      "migration",
      "database",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Database schema design, indexing, and migration guidance for MongoDB-based applications. Use when adding or changing MongoDB collections, indexes, or fields, designing schema for multi-tenant or large datasets, or planning forward-only migrations."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/mongodb-migration-expert/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/mongodb-migration-expert/SKILL.md",
      "key": "shipshitdev/skills/skills/mongodb-migration-expert/SKILL.md"
    }
  },
  "instructions": "# MongoDB Migration Expert\n\nDesign schema changes and migrations that are safe, indexed, and backwards compatible.\n\n## When to Use\n\n- Adding or changing MongoDB collections, indexes, or fields\n- Designing schema patterns for multi-tenant or large datasets\n- Planning forward-only migrations\n\n## Core Principles\n\n- Schema changes are additive first, destructive later.\n- Backfill data in batches; avoid locking large collections.\n- Indexes must match query patterns.\n- Keep migrations idempotent and observable.\n\n## Migration Workflow\n\n1) Add new fields with defaults or nullable values.\n2) Deploy cod",
  "cost": {
    "context_tokens": 298
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-mongodb-migration-expert/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.