database-schema-designer

Design robust, scalable database schemas for SQL and NoSQL databases. Provides normalization guidelines, indexing strategies, migration patterns, constraint design, and performance optimization. Ensures data integrity, query performance, and maintainable data models.

By softaworks · 4,198 installs

npx skills add softaworks/agent-toolkit --skill database-schema-designer

Source repository · Upstream listing

Database Schema Designer Design production ready database schemas with best practices built in. Quick Start Just describe your data model: You'll get a complete SQL schema like: What to include in your request: Entities (users, products, orders) Key relationships (users have orders, orders have items) Scale hints (high traffic, millions of records) Database preference (SQL/NoSQL) defaults to SQL if not specified Triggers Trigger Example design schema "design a schema for user authentication" database design "database design for multi tenant SaaS" create tables "create tables for a blog system" schema for "schema for inventory management" model data "model data for real time analytics" I need a database "I need a database for tracking orders" design NoSQL "design NoSQL schema for product catalog" Key Terms Term Definition Normalization Organizing data to reduce redundancy (1NF → 2NF → 3NF) 3NF Third Normal Form no transitive dependencies between columns OLTP Online Transaction Processing write heavy, needs normalization OLAP Online Analytical Processing read heavy, benefits from denormalization Foreign Key (FK) Column that references another table's primary key Index Data structure that speeds up queries (at cost of slower writes) Access Pattern How your app reads/writes data (queries, joins, filters) Denormalization Intentionally duplicating data to speed up reads Quick Reference Task Approach Key Consideration New schema Normalize to 3NF first Domain modeling over UI SQL vs NoSQL Access patterns decide Read/write ratio matters Primary keys INT or UUID UUID for distributed systems Foreign keys Always constrain ON DELETE strategy critical Indexes FKs + WHERE columns Column order matters Migrations Always reversible Backward compatible first Process Overview Commands Command When to Use Action design schema for {domain} Starting fresh Full schema generation normalize {table} Fixing existing table Apply normalization rules add indexes for {table} Performance issues Generate index strategy migration for {change} Schema evolution Create reversible migration review schema Code review Audit existing schema Workflow: Start with design schema → iterate with normalize → optimize with add indexes → evolve with migration Core Principles Principle WHY Implementation Model the Domain UI changes, domain doesn't Entity names reflect business concepts Data Integrity First Corruption is costly to fix Constraints at database level Optimize for Access Pattern Can't optimize for both OLTP: normalized, OLAP: denormalized Plan for Scale Retrofitting is painful Index strategy + partitioning plan Anti Patterns Avoid Why Instead VARCHAR(255) everywhere Wastes storage, hides intent Size appropriately per field FLOAT for money Rounding errors DECIMAL(10,2) Missing FK constraints Orphaned data Always define foreign keys No indexes on FKs Slow JOINs Index every foreign key Storing dates as strings Can't compare/sort DATE, TIMESTAMP types SELECT in queries Fetches unnecessary data Explicit column lists Non reversible migrations Can't rollback Always write DOWN migration Adding NOT NULL without default Breaks existing rows Add nullable, backfill, then constrain Verification Checklist After designing a schema: [ ] Every table has a primary key [ ] All relationships have foreign key constraints [ ] ON DELETE strategy defined for each FK [ ] Indexes exist on all foreign keys [ ] Indexes exist on frequently queried columns [ ] Appropriate data types (DECIMAL for money, etc.) [ ] NOT NULL on required fields [ ] UNIQUE constraints where needed [ ] CHECK constraints for validation [ ] created at and updated at timestamps [ ] Migration scripts are reversible [ ] Tested on staging with production data <details <summary <strong Deep Dive: Normalization (SQL)</strong </summary Normal Forms Form Rule Violation Example 1NF Atomic values, no repeating groups product ids = '1,2,3' 2NF 1NF + no partial dependencies customer name in order items 3NF 2NF + no transitive dependencies country derived from postal code 1st Normal Form (1NF) 2nd Normal Form (2NF) 3rd Normal Form (3NF) When to Denormalize Scenario Denormalization Strategy Read heavy reporting Pre calculated aggregates Expensive JOINs Cached derived columns Analytics dashboards Materialized views </details <details <summary <strong Deep Dive: Data Types</strong </summary String Types Type Use Case Example CHAR(n) Fixed length State codes, ISO dates VARCHAR(n) Variable length Names, emails TEXT Long content Articles, descriptions Numeric Types Type Range Use Case TINYINT 128 to 127 Age, status codes SMALLINT 32K to 32K Quantities INT 2.1B to 2.1B IDs, counts BIGINT Very large Large IDs, timestamps DECIMAL(p,s) Exact precision Money FLOAT/DOUBLE Approximate Scientific data Date/Time Types Boolean </details <details <summary <strong Deep Dive: Indexing Strategy</strong </summary When to Create Indexes Always Index Reason Foreign keys Speed up JOINs WHERE clause columns Speed up filtering ORDER BY columns Speed up sorting Unique constraints Enforced uniqueness Index Types Type Best For Example B Tree Ranges, equality price 100 Hash Exact matches only email = 'x@y.com' Full text Text search MATCH AGAINST Partial Subset of rows WHERE is active = true Composite Index Order Rule: Most selective column first, or column most queried alone. Index Pitfalls Pitfall Problem Solution Over indexing Slow writes Only index what's queried Wrong column order Unused index Match query patterns Missing FK indexes Slow JOINs Always index FKs </details <details <summary <strong Deep Dive: Constraints</strong </summary Primary Keys Foreign Keys Strategy Use When CASCADE Dependent data (order items) RESTRICT Important references (prevent accidents) SET NULL Optional relationships Other Constraints </details <details <summary <strong Deep Dive: Relationship Patterns</strong </summary One to Many Many to Many Self Referencing Polymorphic </details <details <summary <strong Deep Dive: NoSQL Design (MongoDB)</strong </summary Embedding vs Referencing Factor Embed Reference Access pattern Read together Read separately Relationship 1:few 1:many Document size Small Approaching 16MB Update frequency Rarely Frequently Embedded Document Referenced Document MongoDB Indexes </details <details <summary <strong Deep Dive: Migrations</strong </summary Migration Best Practices Practice WHY Always reversible Need to rollback Backward compatible Zero downtime deploys Schema before data Separate concerns Test on staging Catch issues early Adding a Column (Zero Downtime) Renaming a Column (Zero Downtime) Migration Template </details <details <summary <strong Deep Dive: Performance Optimization</strong </summary Query Analysis Look For Meaning type: ALL Full table scan (bad) type: ref Index used (good) key: NULL No index used rows: high Many rows scanned N+1 Query Problem Optimization Techniques Technique When to Use Add indexes Slow WHERE/ORDER BY Denormalize Expensive JOINs Pagination Large result sets Caching Repeated queries Read replicas Read heavy load Partitioning Very large tables </details Extension Points 1. Database Specific Patterns: Add MySQL vs PostgreSQL vs SQLite variations 2. Advanced Patterns: Time series, event sourcing, CQRS, multi tenancy 3. ORM Integration: TypeORM, Prisma, SQLAlchemy patterns 4. Monitoring: Query performance tracking, slow query alerts