schema-reviewer

Analyze PostgreSQL and MySQL schemas for normalization, constraints, and indexing issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/physics91/claude-vibe --skill schema-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-reviewer
Source: https://github.com/physics91/claude-vibe/tree/main/skills/schema-reviewer
Command: npx skills add https://github.com/physics91/claude-vibe --skill schema-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reviews database schemas for normalization, constraints, data types, and indexing strategies, improving data integrity and query performance.

Core Features & Use Cases

  • Normalization checks (3NF, etc.)
  • Constraint validation (PK/FK/NOT NULL/UNIQUE)
  • Data type optimization and enums
  • Index strategy planning (FK indexes, composite, partial)
  • Use Case: Evaluate a PostgreSQL schema for robust constraints and efficient querying.

Quick Start

Analyze the project’s schema files to surface design improvements and indexing recommendations.

Frequently Asked Questions about schema-reviewer

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

FAQPage Schema
How do I identify normalization issues in my PostgreSQL or MySQL schema?

Normalization analysis evaluates whether your schema follows third normal form (3NF) by examining table structure, column dependencies, and data redundancy. This Skill reviews your schema files to surface violations and recommend decomposition or restructuring to eliminate anomalies and improve data integrity.

What database constraints should I enforce, and how do I add them?

Primary keys, foreign keys, unique constraints, and NOT NULL declarations enforce data integrity rules. This Skill validates existing constraints in your schema and provides SQL recommendations to add missing constraints, preventing invalid data and orphaned records.

How do I choose the right data types for my database columns?

Data type selection balances storage efficiency, query performance, and semantic correctness. This Skill analyzes your schema's column types and suggests optimizations—such as enum usage, integer ranges, and text encoding—to reduce storage and improve constraint enforcement.

What indexing strategy should I use to improve query performance?

Index strategy covers foreign key indexes, composite indexes on common filter combinations, and partial indexes for filtered queries. This Skill evaluates your schema against query patterns and recommends specific index designs for PostgreSQL and MySQL to accelerate lookups without overhead.

Can I use this Skill to review migration files and entity definitions?

Yes. This Skill analyzes PostgreSQL and MySQL schemas across migration files, entity definitions, and documentation. It applies the same normalization, constraint, data type, and indexing checks to guide design improvements throughout your schema lifecycle.

What's the difference between fixing normalization and adding indexes?

Normalization restructures tables to eliminate redundancy and improve data integrity; indexing accelerates queries without changing structure. This Skill addresses both: normalization corrections remove anomalies, while index strategies optimize retrieval for normalized schemas.