migration skill
Use when an old estate of jobs and tables has to move to a new platform, to inventory it, rate it, and write the migration plan with scenarios, acceptance numbers, the parallel run and the rollback.
- GitHub stars
- 102
- Files
- 1
- Last commit
- Nov 6, 2026
- License
- MIT
- Allowed tools
- —
What does the migration skill do?
migration uses when an old estate of jobs and tables has to move to a new platform, to inventory it, rate it, and write the migration plan with scenarios, acceptance numbers, the parallel run and the rollback.
How to install the migration skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the migration skill in Plugin
/plugin marketplace add DataWithBaraa/claude-code-data-engineering-skills /plugin install data-engineering@data-with-baraa
Install the migration skill in Claude Code
~/.claude/skills/migration/SKILL.md
$ npx degit DataWithBaraa/claude-code-data-engineering-skills/skills/migration ~/.claude/skills/migrationInstall the migration skill in Claude Code (project)
.claude/skills/migration/SKILL.md
$ npx degit DataWithBaraa/claude-code-data-engineering-skills/skills/migration .claude/skills/migrationInstall the migration skill in Codex
~/.agents/skills/migration/SKILL.md
$ npx degit DataWithBaraa/claude-code-data-engineering-skills/skills/migration ~/.agents/skills/migrationInstall the migration skill in Gemini CLI
~/.gemini/skills/migration/SKILL.md
$ npx degit DataWithBaraa/claude-code-data-engineering-skills/skills/migration ~/.gemini/skills/migrationInstall the migration skill in Claude.ai
npx degit DataWithBaraa/claude-code-data-engineering-skills/skills/migration migration && zip -r migration.zip migration # claude.ai → Customize → Skills → + → Create skill → Upload a skill → migration.zip
SKILL.md
View on GitHubMigration
The job: from the old estate to a migration plan with scenarios, acceptance numbers, a parallel run and a rollback. It plans, it migrates nothing.
Input: the folder, the inventory or the documentation of the old estate.
Steps
- Inventory the old estate: jobs, tables, schedules, owners, consumers.
- Explain every job in three plain lines: inputs, logic, output.
- Draw the lineage of the old estate.
- Rate each job: risk, size, value, dead or alive.
- Propose the cut list, with the reason for each.
- Gather the requirements for the new platform.
- Compare at least two target platforms on the requirements.
- Propose the migration type per job: lift and shift, re-platform, re-engineer.
- Design the target: where each kept job lands.
- Map old to new, one row per old output.
- Propose the order, in waves, the smallest proven one first.
- Three scenarios: best, expected, worst, with effort and risk.
- Define the acceptance numbers, per output, with the tolerance.
- Plan the parallel run: old and new side by side, every output compared, for how long, before the cutover.
- Plan the history load, the cutover, the rollback and the decommission of the old jobs.
- Write the migration plan, decisions marked open for the data engineer.
Output
One migration plan: the inventory and its ratings, the cut list, the target, the waves, the scenarios, the acceptance numbers, the parallel run, the cutover and the rollback, with the open decisions marked.
Reads
- the old estate, the knowledge of the new platform
Writes
- the migration plan
Never
- Never migrates anything: it plans.
Files in this skill
1migration skill questions
How do I install the migration skill in Claude Code?
Run npx degit DataWithBaraa/claude-code-data-engineering-skills/skills/migration ~/.claude/skills/migration. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the migration skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.