Data and Schema Migration

Use when changing a persisted database schema, configuration shape, event contract, or serialized format that existing data or running versions already use; design compatibility, backfill, cutover, and recovery before mutation.

9 stars 3 forksDatabases

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill data-and-schema-migration
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/data-and-schema-migration ~/.claude/skills/data-and-schema-migration

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Data and Schema Migration

Use this skill for persisted database tables, configuration, messages/events, indexes, and serialized on-disk formats. The invariant is: old data must remain readable during the supported transition, and every destructive step must have verified prerequisites and a recovery path.

Do not use it for code-only symbol renames. Do not assume a database transaction can reverse an external side effect, a large backfill, or a destructive data transformation.

## Establish the migration contract

Before changing data, record:

- current and target schemas, invariants, volume, growth, ownership, and retention;
- readers and writers, including jobs, older application versions, replicas, consumers, exports, caches, and recovery tooling;
- compatibility window and deployment order;
- data sensitivity, regulatory constraints, availability budget, and acceptable lag;
- objective completion checks, abort thresholds, and who may authorize cutover or destructive cleanup.

Inspect representative production-shaped data safely. Include nulls, duplicates, invalid legacy values, maximum sizes, different encodings/time zones, and partially migrated records. Redact sensitive samples and do not copy production data into an uncontrolled environment.

## Prefer expand, migrate, contract

1. **Expand:** add backward-compatible fields, tables, indexes, or readers. Avoid renaming, narrowing, dropping, or changing semantics in place.
Read the full skill on GitHub

Details

Skill name
data-and-schema-migration
Path
skills/data-and-schema-migration/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Data and Schema Migration skill do?

Use when changing a persisted database schema, configuration shape, event contract, or serialized format that existing data or running versions already use; design compatibility, backfill, cutover, and recovery before mutation.

How do I install the Data and Schema Migration skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill data-and-schema-migration. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Data and Schema Migration popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all databases skills, or write your own with the skills generator.