Agent skill

Reversible Migration

by JuliusBrussee in JuliusBrussee/caveman

“Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof.”

— description from SKILL.md by JuliusBrussee
Apache-2.0Auto-check passedDevelopment

Install Reversible Migration

skills CLI
$ npx skills add JuliusBrussee/caveman --skill migration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JuliusBrussee/caveman migration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JuliusBrussee/caveman.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/migration .claude/skills/migration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
migration
GitHub stars
110k
Used in
1 other repo
Token cost
~196 tokens
SKILL.md length
73 words
Files
2
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Reversible Migration is a skill in JuliusBrussee/caveman (110k stars). Its SKILL.md is about 196 tokens, with 1 other file in the folder, and copies of it appear in 1 other owners' repositories. Licence: Apache-2.0.

What it can do on your machine

Read from SKILL.md and the folder at commit 538b491. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reversible Migration loads about 196 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 73 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~196

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JuliusBrussee/caveman at commit 538b491, republished under its Apache-2.0 licence (© JuliusBrussee). 73 words, ~196 tokens.

Download SKILL.mdSave it as .claude/skills/migration/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/migration of JuliusBrussee/caveman.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 538b491

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in JuliusBrussee/caveman, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Reversible Migration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reversible Migration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reversible Migration this skillJuliusBrussee/caveman110k1 repos~196Automated safety check: PassApache-2.0
Saleor Port Changessaleor/saleor23k—~969Automated safety check: PassBSD-3-Clause
Migratecodewithmukesh/dotnet-claude-kit751—~1.7kAutomated safety check: PassMIT
Framework Migration Code Migrateaiskillstore/marketplace4307 repos~636Automated safety check: PassNone
Version Bump Advisormurphytrueman/design-system-ops203—~2.9kAutomated safety check: PassMIT
SchematicsSAP/spartacus784—~434Automated safety check: PassApache-2.0

Similar skills

  • Saleor Port Changes

    saleor/saleor

    Forward-ports or backports a single PR or branch onto the currently checked-out Saleor branch, handling GraphQL version markers and migration numbering along the way.

    23k GitHub stars~969 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Migrate

    codewithmukesh/dotnet-claude-kit

    Guided, safe migration workflow covering EF Core schema migrations, .NET version upgrades, and NuGet dependency updates — each with rollback strategies and verification steps.

    751 GitHub stars~1.7k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Framework Migration Code Migrate

    aiskillstore/marketplace

    You are a code migration expert specializing in transitioning codebases between frameworks, languages, versions, and platforms.

    430 GitHub starsUsed in 7 repos~636 tokens
    DevelopmentAuto-check passed
  • Version Bump Advisor

    murphytrueman/design-system-ops

    Decide the semver bump (major, minor or patch) for a design system release from a diff or change list, with reasoning and a CHANGELOG entry.

    203 GitHub stars~2.9k tokensUpdated 14 days ago
    DevelopmentAuto-check passed
  • Schematics

    SAP/spartacus

    Official

    A skill your agent uses when working with Spartacus schematics - Angular schematics for installing, configuring, and migrating Spartacus libraries.

    784 GitHub stars~434 tokensUpdated today
    DevelopmentAuto-check passed
  • Adds an upgrade-instruction fragment to a Prisma 8 breaking-change PR so downstream app and extension authors can apply the matching code translation.

    48k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check: notes

More from JuliusBrussee/caveman

All 18 skills in this repo
  • Caveman Workflow Labeler

    JuliusBrussee/caveman

    Finds every LLM workflow in a repository, proposes a labeling table and, once you agree, wires labels so Caveman Cloud groups spend per workflow.

    110k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Caveman Evidence Review

    JuliusBrussee/caveman

    Read-only review of Caveman Cloud data to explain where LLM spend goes: cost, score, workflows, traces, latency, errors, routing and verified savings.

    110k GitHub starsUsed in 1 repo~927 tokens
    Auto-check passed
  • Caveman Experiment Manager

    JuliusBrussee/caveman

    Reads the state and results of Caveman Cloud experiments and reports one recommendation or a block, without changing an experiment's lifecycle itself.

    110k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Caveman Optimization Evaluator

    JuliusBrussee/caveman

    Turns a Caveman report-only optimization observation into one minimal code change and a paired baseline evaluation, after the operator picks which to pursue.

    110k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Caveman Gateway Setup

    JuliusBrussee/caveman

    Routes every LLM call in a repository through the Caveman Cloud gateway in record mode, so requests and costs are measured without changing behavior.

    110k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check: warnings
  • Caveman Help Card

    JuliusBrussee/caveman

    Quick-reference card for the three caveman skills and their commands. Trigger: /caveman-help or "caveman help".

    110k GitHub stars~690 tokensUpdated today
    Auto-check passed

Questions about Reversible Migration

How do I install Reversible Migration in Claude Code?

Run `npx skills add JuliusBrussee/caveman --skill migration -a claude-code`. Or copy the skill folder (skills/migration in JuliusBrussee/caveman) into .claude/skills/migration in your project. Claude Code loads it when a task matches its description.

How do I install Reversible Migration in Codex?

Run `npx skills add JuliusBrussee/caveman --skill migration -a codex`. Or copy the skill folder (skills/migration in JuliusBrussee/caveman) into .agents/skills/migration in your project. Codex loads it when a task matches its description.

Can I use Reversible Migration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JuliusBrussee/caveman --skill migration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/migration, .gemini/skills/migration, .github/skills/migration and .opencode/skills/migration in your project.

What does Reversible Migration need to run?

SKILL.md names no scripts, command-line tools or credentials: Reversible Migration is instructions for the agent only.

Does Reversible Migration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reversible Migration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reversible Migration use?

Reversible Migration is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reversible Migration use?

About 196 tokens (SKILL.md is roughly 784 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reversible Migration?

Skills that share tags, products or a category with Reversible Migration: Saleor Port Changes (saleor/saleor, 23k stars), Migrate (codewithmukesh/dotnet-claude-kit, 751 stars), Framework Migration Code Migrate (aiskillstore/marketplace, 430 stars) and Version Bump Advisor (murphytrueman/design-system-ops, 203 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reversible Migration?

JuliusBrussee (a GitHub user) maintains it in JuliusBrussee/caveman, which has 110,443 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 8, 2026.

Source: JuliusBrussee/caveman on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.