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
npx skills add borghei/Claude-Skills --skill migration-architect -a claude-codeWhat 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.jsonand save the result as JSON. - Compare
assets/database_schema_before.jsonwithassets/database_schema_after.jsonas database schemas. - Generate a rollback runbook from
plan.jsonwithrollback_generator.py.
How to install migration-architect
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill migration-architect -a claude-code2Manually: put the files in place
~/.claude/skills/migration-architect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/migration-architect/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill migration-architect -a codex2Manually: put the files in place
.agents/skills/migration-architect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill migration-architect -a cursor2Manually: put the files in place
.cursor/skills/migration-architect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/migration-architect/SKILL.md2Manually: put the files in place
.github/skills/migration-architect/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill migration-architect -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/migration-architectManually: put the files in place
.devin/skills/migration-architect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill migration-architect -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.