db-schema-keeper

Manage database schemas via schema.sql and migrations/sql.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/united-software-platform/req-control --skill db-schema-keeper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: db-schema-keeper
Source: https://github.com/united-software-platform/req-control/tree/main/.claude/skills/db-schema-keeper
Command: npx skills add https://github.com/united-software-platform/req-control --skill db-schema-keeper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a single source of truth for database schema management and a formal protocol for safe, auditable changes.

Core Features & Use Cases

  • Reads the central schema file docs/database/schema.sql and uses it as the definitive source of truth.
  • Generates and applies migrations in migrations/sql to evolve the schema.
  • Updates docs/database/schema.sql via Edit to reflect the actual schema.
  • Appends a changelog entry describing each structural change for traceability.

Quick Start

Read docs/database/schema.sql first and then perform the requested change following the protocol.

Frequently Asked Questions about db-schema-keeper

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

FAQPage Schema
How do I manage database schema changes and maintain consistency across migrations?

You can manage database schema changes by using a central schema file as a single source of truth, generating formal migrations in a dedicated sql directory, and updating the central schema file to reflect the actual database structure.

What is the best way to track database schema migrations for traceability?

Tracking database schema migrations for traceability involves appending a changelog entry describing each structural change after generating the migration and updating the central schema file to maintain a unified record of database evolution.

How do I create and update database tables, indexes, and foreign keys safely?

To safely create and update database tables, indexes, and foreign keys, follow a formalized protocol that reads a central schema file, generates specific migrations, and applies structural changes through auditable steps.

Can I use a single source of truth for database schema management in my project?

Yes, you can use a single source of truth for database schema management by maintaining a central schema file that is read first and subsequently updated via edits to reflect any structural changes made through generated migrations.

Why does my database schema documentation keep falling out of sync with migrations?

Database schema documentation falls out of sync when migrations are applied without updating a central source of truth, a problem solved by enforcing a protocol that updates the schema file and appends a changelog entry for every change.

What are the limitations of managing database schemas without a unified protocol?

Without a unified protocol, database schema management lacks auditability and consistency, risking structural drift because migrations are not formally tied to a central source of truth or documented via a changelog.