database-migration-runner

Execute SQLite database migrations with backups and rollback support.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fedickinson/budget-buddy-2 --skill database-migration-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: database-migration-runner
Source: https://github.com/fedickinson/budget-buddy-2/tree/main/.claude/skills/database-migration-runner
Command: npx skills add https://github.com/fedickinson/budget-buddy-2 --skill database-migration-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely manage database schema changes by providing a repeatable, auditable migration workflow that protects data through backups, ordered execution, and built-in rollback support.

Core Features & Use Cases

  • List pending migrations and review their intent before applying changes.
  • Back up the SQLite database prior to migration and verify the backup integrity.
  • Execute migrations in the correct order, validate schema changes, and provide a rollback path if something goes wrong.
  • Use cases include adding tables or columns, altering schemas, and applying structural changes across development, staging, and production with safety nets.

Quick Start

Follow the migration workflow from the project root by listing, backing up, reviewing, executing, and verifying migrations.

Frequently Asked Questions about database-migration-runner

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

FAQPage Schema
How do I safely apply SQLite schema changes across staging and production environments?

To safely apply SQLite schema changes, use a migration workflow that creates a verified backup, executes scripts in order, validates the schema, and provides a rollback path. This protects data across development, staging, and production environments.

What is the safest way to add tables or columns to an existing SQLite database?

The safest way to add tables or columns is using a structured migration process that creates a database backup prior to execution, applies changes in the correct order, and validates the schema updates before finalizing them.

Can I rollback a database migration if the schema update fails?

Yes, rollback support is built into the database migration workflow. If a schema update fails or produces unexpected results, you can revert the database to its pre-migration state using the backup created prior to execution.

How do I list and review pending database migrations before applying them?

You can list pending migrations from the project root to review their intent before applying changes. This step allows you to verify the structural modifications in the migration scripts before executing them against the SQLite database.

Do I need a specific directory structure for SQLite database migration scripts?

Yes, you need a /backend/database/migrations directory containing your migration scripts, access to the budget_buddy.db SQLite database file, and the ability to create backups and verify migrations from the project root.

Why should I verify a database backup before running a schema migration?

Verifying a database backup before running a schema migration ensures the backup integrity is intact, guaranteeing that you have a reliable restore point for rollback support if the migration fails or corrupts data.