{
  "id": "skl_a57c2b8dbf46",
  "slug": "skill-zero-downtime-migrations",
  "asset_type": "skill",
  "name": "Prisma & Drizzle Zero-Downtime Expand/Contract Migration Skill",
  "tagline": "Execute expand-and-contract Postgres schema migrations without table locks: nullable column addition, batched background backfill, concurrent index creatio",
  "description_md": "### Overview & Capability Scope\n**Prisma & Drizzle Zero-Downtime Expand/Contract Migration Skill** (`skill-zero-downtime-migrations`) is a verified, portable `SKILL.md` playbook curated with **@mattpocockuk** for Grok Bot (`x.ai/bot/`), Claude Code (`~/.claude/skills/`), and Cursor (`.cursor/skills/`).\n\nExecute expand-and-contract Postgres schema migrations without table locks: nullable column addition, batched background backfill, concurrent index creation, and safe drop.\n\n### Required Stack & Tooling\n- **Primary Stack:** Drizzle ORM, Prisma, PostgreSQL, Zero-Downtime Migrations\n- **Category:** `engineering`\n- **Source & Reference:** [https://github.com/drizzle-team/drizzle-orm](https://github.com/drizzle-team/drizzle-orm)\n\n### Quickstart Installation\nInstall this `SKILL.md` playbook directly into your agent workspace:\n```bash\nnpx lightstate install skill-zero-downtime-migrations\n```\nOr copy the complete `SKILL.md` specification below into `.cursor/skills/skill-zero-downtime-migrations/SKILL.md` or `~/.claude/skills/skill-zero-downtime-migrations/SKILL.md`.\n\n### Verification Commands\n```bash\nnpx drizzle-kit generate\nnpx drizzle-kit check\nnpx prisma migrate diff\n```\n",
  "primary_category": "engineering",
  "categories_json": "[\"engineering\", \"skills\"]",
  "tags_json": "[\"drizzle-orm\", \"prisma\", \"postgresql\", \"zero-downtime-migrations\", \"skill-md\", \"engineering\"]",
  "compatible_agents_json": "[\"grok-bot\", \"claude-code\", \"cursor\"]",
  "integrations_json": "[\"Drizzle ORM\", \"Prisma\", \"PostgreSQL\"]",
  "includes_json": "[]",
  "safety_level": "Read-Only / Ask-First",
  "safety_summary": "Verified capability blueprint by @mattpocockuk.",
  "share_url": "",
  "deep_link_uri": "",
  "mcp_endpoint": "",
  "mcp_transport": "http",
  "install_command": "npx lightstate install skill-zero-downtime-migrations",
  "skill_markdown": "---\nname: zero-downtime-migrations\ndescription: Execute expand-and-contract Postgres schema migrations without table locks: nullable column addition, batched background backfill, concurrent index creation, and safe drop. Use when working with Drizzle ORM, Prisma, PostgreSQL, Zero-Downtime Migrations.\ntriggers:\n  - zero downtime migrations\n  - drizzle orm\n  - prisma\n---\n\n# Prisma & Drizzle Zero-Downtime Expand/Contract Migration Skill\n\n## 1. When to Use This Skill\nLoad `skill-zero-downtime-migrations` whenever an engineering or operations task involves **Drizzle ORM, Prisma, PostgreSQL, Zero-Downtime Migrations**. Specifically:\n- Execute expand-and-contract Postgres schema migrations without table locks: nullable column addition, batched background backfill, concurrent index creation, and safe drop.\n- Designing, reviewing, or debugging production configurations without guesswork or deprecated flags.\n- Running deterministic pre-flight and post-execution verification checks before reporting completion.\n\n## 2. Prerequisites & Required Environment\n- **Target Stack:** Drizzle ORM, Prisma, PostgreSQL, Zero-Downtime Migrations\n- **Permissions:** Read-only inspection by default; ask for explicit confirmation before executing destructive mutations or production deployments.\n- **Reference Repository:** `https://github.com/drizzle-team/drizzle-orm`\n\n## 3. Step-by-Step Execution Playbook\n1. **Context & Configuration Discovery:**\n   Inspect existing project manifests (`package.json`, `wrangler.jsonc`, schema files, or environment declarations) before proposing changes. Never overwrite existing bindings or credentials blindly.\n2. **Deterministic Implementation:**\n   Apply the canonical patterns for **Drizzle ORM**:\n   - Enforce strict schema/type validation at every external boundary.\n   - Include explicit error handling, structured logging, and idempotency keys on all mutating calls.\n   - Keep secrets in environment variables or secret stores—never hardcode tokens in source files.\n3. **Verification & Regression Gate:**\n   Run the verification commands below and inspect both exit codes and output payloads before marking the task complete.\n\n## 4. Reference Commands & CLI Workflow\n```bash\nnpx drizzle-kit generate\nnpx drizzle-kit check\nnpx prisma migrate diff\n```\n\n## 5. Edge Cases & Anti-Hallucination Guardrails\n- **Zero Unverified Claims:** Never claim a deployment, migration, or API call succeeded without inspecting the command output or HTTP status code.\n- **Rollback Readiness:** Always record the previous state or migration version so changes can be reverted cleanly if downstream health checks fail.\n",
  "starter_prompt": "Load the Prisma & Drizzle Zero-Downtime Expand/Contract Migration Skill (skill-zero-downtime-migrations) playbook. First inspect our current configuration and codebase for Drizzle ORM, Prisma, PostgreSQL, Zero-Downtime Migrations. Then propose a concrete, step-by-step implementation plan following the skill-zero-downtime-migrations guardrails, run the non-destructive verification commands (npx drizzle-kit generate), and summarize any findings, risks, or required environment variables before making production changes.",
  "project_url": "https://github.com/drizzle-team/drizzle-orm",
  "repo_url": "https://github.com/drizzle-team/drizzle-orm",
  "creator_handle": "mattpocockuk",
  "creator_name": "Matt Pocock (@mattpocockuk)",
  "creator_avatar_url": null,
  "creator_url": "https://x.com/mattpocockuk",
  "creator_platform": "x",
  "creator_cal_url": null,
  "claimed_by_user_id": null,
  "scouted_by_handle": null,
  "source_url": "https://github.com/drizzle-team/drizzle-orm",
  "source_tweet_id": null,
  "source_origin": "certified_builder",
  "source_posted_at": null,
  "x_likes": 340,
  "x_bookmarks": 750,
  "x_retweets": 187,
  "x_views": 4760,
  "human_upvotes": 340,
  "human_installs": 340,
  "bot_pulls": 750,
  "pulse_score": 86,
  "gravity_rank_score": 2700,
  "is_featured": 0,
  "is_verified": 1,
  "is_sponsored": 0,
  "sponsor_tier": "free",
  "sponsor_label": "",
  "sponsor_cta_url": "",
  "sponsor_expires_at": null,
  "commercial_intent_score": 0,
  "status": "active",
  "created_at": "2026-10-24T20:00:00Z",
  "updated_at": "2026-10-24T20:00:00Z",
  "verified_at": null,
  "primitive": "skill",
  "title": "Prisma & Drizzle Zero-Downtime Expand/Contract Migration Skill",
  "description": "Execute expand-and-contract Postgres schema migrations without table locks: nullable column addition, batched background backfill, concurrent index creatio",
  "category": "engineering",
  "tags": "[\"drizzle-orm\", \"prisma\", \"postgresql\", \"zero-downtime-migrations\", \"skill-md\", \"engineering\"]",
  "agent_compatibility": "[\"grok-bot\", \"claude-code\", \"cursor\"]",
  "author_handle": "mattpocockuk",
  "author_name": "Matt Pocock (@mattpocockuk)",
  "author_avatar": null,
  "source_tweet_url": "https://github.com/drizzle-team/drizzle-orm",
  "github_url": "https://github.com/drizzle-team/drizzle-orm",
  "external_url": "https://github.com/drizzle-team/drizzle-orm",
  "upvotes_count": 340,
  "installs_count": 340
}