Skip to main content
skill CX Codex

migration-architect · borghei — Claude Code skill: install

migration-architect — a skill for Claude Code plans staged migrations for databases, APIs, services, and infrastructure. It checks schema compatibility and prepares rollback steps before cutover.

LicenseRef-MIT-Commons-Clause 126 installs ★ 1,183 updated 2026-11-08

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill migration-architect -a claude-code
Open on GitHub

What migration-architect does

The skill creates phased migration plans with risk assessment and validation gates, compares database or REST/JSON schemas, and prepares a reversal runbook for the cutover.

Three CLI scripts are included. migration_planner.py turns a JSON migration spec into a plan, compatibility_checker.py flags potentially breaking changes, and rollback_generator.py builds a runbook from the plan. The skill covers patterns such as Expand-Contract, Dual-Write, CDC, Strangler Fig, Parallel Run, Canary, and Blue-Green.

The scripts use python3, and the quick-start flow writes generated files outside the repository. Exit code 1 signals potentially breaking compatibility findings; 2 means the input cannot be used because a file, JSON structure, or required field is invalid.

What it helps with

  • plan a staged database migration
  • compare before-and-after API schemas
  • detect breaking changes before cutover
  • generate a rollback runbook from a plan
  • set validation gates for a migration

Example prompts for the agent

  • Plan a database migration from assets/sample_database_migration.json and save the result as JSON.
  • Compare assets/database_schema_before.json with assets/database_schema_after.json as database schemas.
  • Generate a rollback runbook from plan.json with rollback_generator.py.

How to install migration-architect

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill migration-architect -a claude-code

2Manually: put the files in place

~/.claude/skills/migration-architect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/migration-architect/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about migration-architect

How do I install migration-architect in Claude Code?

Run npx skills add borghei/Claude-Skills --skill migration-architect -a claude-code, then check ~/.claude/skills/migration-architect/SKILL.md.

What does migration-architect do?

It plans phased migrations for databases, APIs, services, and infrastructure, checks schema compatibility, and creates rollback procedures. Plans include risk assessment and validation gates.

What do the compatibility checker exit codes mean?

Code 0 means no breaking changes were found, 1 reports potentially breaking changes, and 2 marks unusable input such as a missing file, invalid JSON, or missing required field.

Similar skills

All skills for DevOps and infrastructure →

migration-architect by other authors comes first.

migration-architect Alireza Rezvani migration-architect plans database, service, and infrastructure migrations with compatibility checks and rollback paths. Use it for high-risk system changes. CX Codex +1 632installs migration JuliusBrussee migration enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable. CX Codex +1 127,700installs migration-planner patricio0312rev migration-planner turns a database or platform move into ordered phases with feature flags, dual writes, backfill and checks, plus a way back from each step. CX Codex +1 279installs deprecation-and-migration addyosmani deprecation-and-migration is a Claude Code skill for retiring old systems and moving users to replacements. It comes into play for API, feature, or database-schema migrations. CX Codex +1 73,100installs creating-oracle-to-postgres-migration-bug-report official github creating-oracle-to-postgres-migration-bug-report creates structured bug reports for Oracle-to-PostgreSQL migration defects. Use it when a database behaviour difference needs a reproducible report with a cause and validation plan. CX Codex +1 1,800installs ops rainmanjam ops sizes up a deploy before you run it: what cannot be undone, what breaks mid-rollout, and how fast you can back out. CX Codex +1 ★ 26repo stars create-database-migrations davila7 create-database-migrations — a Claude slash command that generates database migration files with versioning and rollback methods. Useful when you change a schema and don't want to hand-write up/down. CX Codex +1 329installs

From the same set120

The whole set →
confluence-expert confluence-expert is a Claude Code skill that audits and designs Confluence spaces by checking page hierarchy, labels, permissions, ownership and stale content. It runs when building or restructuring a wiki. CX Codex +1 131installs observability-designer The observability-designer Claude Code skill plans service observability through SLI/SLOs, alerts, and Grafana dashboards. Use it to shape monitoring for a service or investigate noisy alerts. CX Codex +1 129installs brand-guidelines brand-guidelines writes a brand guideline from scratch and audits existing material against it: voice, palette, type, logo use. CX Codex +1 127installs ms365-tenant-manager ms365-tenant-manager writes PowerShell scripts for Microsoft 365 admins: tenant setup, user onboarding and offboarding, Conditional Access policies and security audits. CX Codex +1 127installs soc2-compliance-expert soc2-compliance-expert manages SOC 2 Type I and Type II readiness against Trust Services Criteria, covering control validation and audit evidence collection. CX Codex +1 126installs saas-scaffolder The saas-scaffolder Claude Code skill lays out a Next.js SaaS starter and guides setup for authentication, billing, and tenant separation. Run it when starting a subscription product or multi-tenant app. CX Codex +1 125installs incident-commander incident-commander — a skill for Claude Code guides production incident response: it scores severity, rebuilds timelines, and drafts postmortems. It also runs on Codex, Cursor, and other platforms. CX Codex +1 125installs tech-debt-tracker tech-debt-tracker — a skill for Claude Code and Codex that audits repositories for technical debt and ranks refactoring backlogs. Calculates cost-of-delay metrics to plan capacity for upcoming sprints. CX Codex +1 125installs

Project sponsors

Companies that keep this analytics open