lms-schema-audit

Audit LMS PostgreSQL schemas for entity-database mismatches, missing indexes, and naming inconsistencies.

6|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/linhlinhlin/LMS_hohulili --skill lms-schema-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lms-schema-audit
Source: https://github.com/linhlinhlin/LMS_hohulili/tree/main/.claude/skills/lms-schema-audit
Command: npx skills add https://github.com/linhlinhlin/LMS_hohulili --skill lms-schema-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

In LMS applications, misaligned PostgreSQL schemas and Entity-DB mappings cause startup failures, difficult migrations, and performance issues. This skill provides a structured, repeatable audit workflow to align JPA entities with database schemas, ensuring consistency and reliability.

Core Features & Use Cases

  • Schema-consistency checks across Flyway migrations, JPA entities, and Spring configuration to surface mismatches early.
  • Domain-pattern verification aligned with common LMS structures (courses, enrollments, quizzes, content blocks) to support scalable design.
  • Migration guidance across environments (Supabase, Neon, local Docker) with actionable steps and risk assessments.

Quick Start

Run a full LMS schema audit to identify entity-to-database mismatches and plan safe migrations.

Frequently Asked Questions about lms-schema-audit

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

FAQPage Schema
How do I audit PostgreSQL schema mismatches with JPA entities in an LMS?

Audit LMS PostgreSQL schema mismatches by comparing Flyway migrations, JPA entities, and Spring configuration to detect inconsistencies between entity mappings and database schemas. This surfaces misalignments early, preventing Hibernate startup failures and migration issues.

Why does Hibernate fail on startup after running Flyway migrations for LMS tables?

Hibernate startup failures after Flyway migrations often result from entity-database mismatches, such as missing indexes or naming inconsistencies between JPA entities and PostgreSQL schemas. A schema audit identifies these exact structural discrepancies causing the errors.

What is the best way to plan PostgreSQL migrations across Supabase and Neon for a learning management system?

The best way to plan migrations across Supabase, Neon, and local Docker is to perform a schema audit that provides actionable migration steps and risk assessments. This ensures LMS domain patterns like courses and enrollments remain structurally consistent.

Can I verify LMS domain patterns like quizzes and enrollments against my PostgreSQL schema?

Yes, you can verify LMS domain patterns like courses, enrollments, and quizzes against your PostgreSQL schema. The audit checks these structures to support scalable database design and ensure domain patterns are implemented correctly.

Do I need Flyway migration scripts to check for missing indexes in my LMS database?

Yes, Flyway migration scripts are required alongside JPA entities and schema documentation to check for missing indexes. Analyzing these components allows the audit to accurately detect naming inconsistencies and structural mismatches.

What are common limitations when auditing Hibernate entity mappings for LMS applications?

A limitation when auditing Hibernate entity mappings is the requirement to provide Flyway migrations, JPA entities, and schema documentation for accurate analysis. Without these inputs, the audit cannot effectively detect entity-database mismatches or provide optimization recommendations.