migration — Claude Code skill: what it does, how to install
Enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable.
npx skills add JuliusBrussee/caveman --skill migration -a claude-codeWhat migration does
Before touching any code, the agent maps readers, writers, payload shapes, and compatibility windows. The skill mandates explicit forward and rollback paths. Destructive actions stay separate because data preservation comes first. When old and new versions run concurrently during a rollout, the workflow protects mixed-version traffic.
Execution follows an expand, migrate, verify, and contract sequence. Retries must remain idempotent so partial failures stay observable without corrupting storage. The agent stops immediately after the requested phase passes instead of executing destructive contractions silently. This discipline pays off on production databases, while blank pet projects will find the procedure unnecessarily strict.
What it helps with
- define verified rollback plans prior to schema modifications
- separate destructive data contractions from rollout preparation
- protect mixed-version operations during overlapping service deployments
- ensure idempotent retries when database transitions fail midway
Example prompts for the agent
- Plan a reversible migration for the accounts schema with fallback
- Run the expand stage for the orders API without contracting old fields
- Verify readers and writers before editing the storage layer
How to install migration
1Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a claude-code2Manually: put the files in place
~/.claude/skills/migration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/migration/
1Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a codex2Manually: put the files in place
.agents/skills/migration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a cursor2Manually: put the files in place
.cursor/skills/migration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install JuliusBrussee/caveman migration2Manually: put the files in place
.github/skills/migration/SKILL.md1Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a gemini-cli2Platform CLI
gemini skills install https://github.com/JuliusBrussee/caveman --path skills/migrationManually: put the files in place
.devin/skills/migration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set22
The whole set →Similar
Questions about migration
How do I install migration in Claude Code?
Run npx skills add JuliusBrussee/caveman --skill migration -a claude-code in your terminal. You can also place the file at ~/.claude/skills/migration/SKILL.md.
What does the migration skill do?
It instructs the agent to audit data shapes, readers, and writers before executing transitions. Every modification requires an explicit rollback path and verifiable checkpoints.
Does the agent automatically delete old columns or endpoints?
No, the skill forbids implicit contraction. Destructive steps require separate, explicit confirmation after the initial stage passes.
Source text
SKILL.md · Apache-2.0
--- name: migration description: Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof. --- # Migration Map current readers, writers, data shape, compatibility window, and ownership before editing. - Define forward path and rollback path. - Preserve existing data; make destructive steps explicit and separately authorized. - Keep mixed-version operation safe where rollout can overlap. - Sequence expand, migrate, verify, then contract when applicable. - Make retries idempotent and partial failure observable. - Verify old and new paths at required transition stages. Stop after requested stage passes; do not perform later destructive contraction implicitly.
© JuliusBrussee · Apache-2.0 · JuliusBrussee/caveman