pgmigrator

Automate incremental PostgreSQL migrations tracked in public.pgMigrations.

6|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/vmkteam/claude-plugins --skill pgmigrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pgmigrator
Source: https://github.com/vmkteam/claude-plugins/tree/main/plugins/developer/skills/pgmigrator
Command: npx skills add https://github.com/vmkteam/claude-plugins --skill pgmigrator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

pgmigrator automates incremental PostgreSQL migrations, tracking applied migrations in public.pgMigrations to prevent drift and ensure reproducible deployments.

Core Features & Use Cases

  • Tracks applied migrations in public.pgMigrations
  • Organizes migrations under docs/patches with naming conventions
  • Supports transactional, non-transactional, and manual migrations with MANUAL suffix

Quick Start

Install pgmigrator and run a dry run to validate your migrations before applying.

Frequently Asked Questions about pgmigrator

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

FAQPage Schema
How do I automate incremental PostgreSQL migrations across multiple environments?

Automating incremental PostgreSQL migrations requires tracking applied schema changes in a dedicated table like public.pgMigrations to prevent drift and ensure reproducible deployments from development to production. The process organizes migration files under a docs/patches folder structure and executes plan, run, dryrun, and verify commands via a CLI binary.

What is the best way to track applied PostgreSQL schema migrations to prevent database drift?

Tracking applied PostgreSQL schema migrations is best achieved by using a dedicated tracking table such as public.pgMigrations. This records each applied migration from your docs/patches directory, ensuring reproducible schema evolution and preventing drift across database environments.

How do I run a dry run to validate PostgreSQL schema migrations before applying them to production?

To run a dry run for PostgreSQL schema migrations, you execute the dryrun command via your migration CLI binary. This validates the pending schema changes located in your docs/patches migration folder structure without modifying the production database.

Does pgmigrator support both transactional and non-transactional database schema migrations?

Yes, PostgreSQL schema migration automation supports transactional, non-transactional, and manual migrations. Manual migrations are specifically designated using a MANUAL suffix in their file naming convention within the docs/patches folder structure.

How do I verify which PostgreSQL schema migrations have been applied to a database?

To verify applied PostgreSQL schema migrations, you execute the verify command through your migration CLI. This checks the database state against the pending files in your docs/patches folder and the records stored in the public.pgMigrations tracking table.

What folder structure do I need to organize PostgreSQL database schema migrations?

Organizing PostgreSQL database schema migrations requires a docs/patches folder structure with specific naming conventions. This directory houses your incremental migration files, including standard transactional scripts and manual migrations designated with a MANUAL suffix.