Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

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.

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

What 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-code

2Manually: put the files in place

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

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

From the same set22

The whole set →
caveman JuliusBrussee Cuts filler and polite greetings from agent responses while keeping technical facts and code exact. Stays active until turned off. Claude Code CX Codex Cursor +1 591,500installs caveman-commit JuliusBrussee Generates terse Conventional Commits messages focused strictly on intent. Ideal for keeping git history clean without boilerplate or AI signatures. Claude Code CX Codex Cursor +1 414,700installs caveman-review JuliusBrussee Generates terse, single-line code review comments with exact line numbers, problems, and fixes. Eliminates conversational filler in pull request reviews. Claude Code CX Codex Cursor +1 410,700installs caveman-compress JuliusBrussee Rewrites CLAUDE.md and todo files into terse caveman-speak so the model reads fewer input tokens. The source gets overwritten; a readable backup stays out of tree. Claude Code CX Codex Cursor +1 410,300installs caveman-help JuliusBrussee A quick reference for Caveman modes and commands in Claude Code and other supported hosts. Use it when you need to control response style or find related skills. Claude Code CX Codex Cursor +1 401,800installs cavecrew JuliusBrussee cavecrew delegates code searches, small edits, and diff reviews to three subagents. Use it when keeping the main agent's context lean matters. Claude Code CX Codex Cursor +1 357,900installs caveman-stats JuliusBrussee Displays recorded output and cache-read tokens for Claude Code sessions or points to host native usage stats. Useful for tracking raw token consumption. Claude Code CX Codex Cursor +1 356,700installs caveman-explore JuliusBrussee A read-only skill locates relevant files and line ranges in a repository. Use it for cold-start orientation or broad searches. Claude Code CX Codex Cursor +1 106,500installs

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

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor