data-migrations-reviewer

Review database migration diffs for data integrity risks.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Andreicr1/netz-analysis-engine --skill data-migrations-reviewer-andreicr1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: data-migrations-reviewer
Source: https://github.com/Andreicr1/netz-analysis-engine/tree/main/.gemini/skills/data-migrations-reviewer
Command: npx skills add https://github.com/Andreicr1/netz-analysis-engine --skill data-migrations-reviewer-andreicr1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Conditional code-review persona that activates when diffs touch migration files, schema changes, data transformations, or backfill scripts. Reviews code for data integrity and migration safety, helping teams avoid deployment-time data inconsistencies.

Core Features & Use Cases

  • Detect mis-mapped IDs and enum values to catch swapped or inverted mappings during migration code.
  • Identify irreversible migrations without rollback plans and assess rollback strategies.
  • Flag missing data backfills for NOT NULL columns and ensure safe defaults.
  • Catch deploy-time schema changes that break running code by verifying references across serializers, APIs, and background jobs.
  • Warn about dual-write during transitions and ensure both old and new columns are updated.
  • Detect missing transaction boundaries in multi-step transforms to prevent partial migrations.
  • Highlight risky index changes on hot tables and consider online/concurrent options.
  • Identify potential data loss from column drops or type changes and propose safeguards.

Quick Start

Review the migration diff and, if touched, enable this skill to evaluate data integrity and deployment safety.

Frequently Asked Questions about data-migrations-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review database migrations for data integrity risks during deployment?

Reviewing database migrations for data integrity involves assessing schema changes and data transformations across deploy windows, rollbacks, and backfills to flag irreversible changes and prevent potential data loss.

How do I check if a schema change breaks running code during a deployment?

Checking if schema changes break running code requires verifying references across serializers, APIs, and background jobs to catch deploy-time inconsistencies and ensure cross-reference integrity.

When do I need to backfill data for NOT NULL columns in database migrations?

You need to backfill data for NOT NULL columns when adding them to existing tables, ensuring safe defaults are present before the migration applies to prevent deployment-time data integrity failures.

What is the best way to handle rollbacks for irreversible database migrations?

Handling rollbacks for irreversible database migrations requires identifying migrations lacking rollback plans and assessing rollback strategies to avoid permanent data loss from column drops or type changes.

Why does a dual-write strategy matter during database schema transitions?

A dual-write strategy matters during schema transitions because it ensures both old and new columns are updated simultaneously, preventing data inconsistencies when migrating between different schema versions.

How do I prevent partial data migrations with multi-step transforms?

Preventing partial data migrations requires detecting missing transaction boundaries in multi-step transforms, ensuring all steps complete successfully or roll back together to maintain data integrity.