migration-manager

Automate Supabase database migrations with pre-flight live schema verification.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/trevorc-ai/PPN-Antigravity-1.0 --skill migration-manager-trevorc-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration-manager
Source: https://github.com/trevorc-ai/PPN-Antigravity-1.0/tree/main/.agent/skills/migration-manager
Command: npx skills add https://github.com/trevorc-ai/PPN-Antigravity-1.0 --skill migration-manager-trevorc-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually coordinating database migrations often leads to FK errors caused by missing or misnamed tables, unverified live schemas, and unsafe edits. The Migration Manager enforces a mandatory pre-flight live schema verification before writing SQL, preventing breakages and safeguarding production data.

Core Features & Use Cases

  • Pre-flight live schema discovery to ground-truth live table names prior to any migration.
  • Governance-driven workflow with clearly defined roles (SOOP, INSPECTOR, USER) and safe SQL generation patterns.
  • Idempotent SQL guidance and patterns that minimize drift across environments (development, staging, production).
  • Use Case: teams migrating Supabase schemas with strict FK dependencies can draft and review SQL safely before execution.

Quick Start

Run the mandatory pre-flight checks and proceed to create safe, idempotent migration SQL according to governance rules.

Frequently Asked Questions about migration-manager

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

FAQPage Schema
How do I prevent FK errors during Supabase schema migrations?

Preventing FK errors during Supabase schema migrations requires pre-flight live schema verification to ground-truth table names before writing SQL. This enforces foreign key integrity and prevents unsafe edits by validating the current database state.

How do I generate idempotent SQL for evolving database schemas?

Generating idempotent SQL for evolving database schemas involves applying safe generation patterns and guardrails to minimize drift across development, staging, and production environments. This ensures controlled change management and reliable execution.

What is pre-flight live schema discovery for database migrations?

Pre-flight live schema discovery for database migrations is the process of verifying actual table names and structures prior to executing changes. It grounds truth in the live state to prevent breakages and safeguard production data from misnamed tables.

Can I enforce role-based governance for SQL migrations across multiple environments?

You can enforce role-based governance for SQL migrations across multiple environments using defined roles like SOOP, INSPECTOR, and USER. This governance-driven workflow enables teams to draft and review SQL safely before execution across development, staging, and production.

What's the best way to manage controlled schema changes in Supabase?

The best way to manage controlled schema changes in Supabase is enforcing mandatory pre-flight live schema verification before writing SQL. This approach applies guardrails to ensure reliable foreign key integrity and controlled change management across evolving schemas.