mariadb-agents-schema-reviewer

Installation
SKILL.md

mariadb-agents-schema-reviewer

A deterministic procedure for reviewing a MariaDB schema (CREATE TABLE DDL, migration script, or existing schema dump) before it ships. This is an ORCHESTRATION skill : it does not teach syntax, it applies a fixed 10-dimension checklist and produces a graded findings report. Every check cites the canonical skill that explains the underlying rule.

Quick Reference

  • Run ALL 10 review dimensions in order. Never skip a dimension because the schema "looks fine".
  • Grade every finding with one of three severities : BLOCKER, WARNING, SUGGESTION.
  • BLOCKER : the schema must not ship. Examples : MyISAM on a transactional table, a table with no PRIMARY KEY, FLOAT used for a money column.
  • WARNING : the schema works but carries a known cost or footgun. Examples : CHAR(36) UUID-text PK on InnoDB, utf8 (utf8mb3) charset on text columns, a multi-tenant table with no leftmost tenant_id index.
  • SUGGESTION : a stylistic or maintainability improvement. Examples : inconsistent naming case, oversized VARCHAR, TEXT where VARCHAR fits.
  • Every finding cites the canonical skill that explains the rule. NEVER report a problem without a skill-ref.
  • Output a single findings table : dimension, severity, location, problem, fix, skill-ref. Close with a verdict line.
  • A clean schema still gets a report : the table has zero rows and the verdict is PASS.

The 10 Review Dimensions

Installs
1
GitHub Stars
2
First Seen
Oct 9, 2026