MariaDB Agent Skills

Short SKILL.md briefings for AI coding agents — so they get right what they often get wrong about MariaDB (MySQL compatibility, vectors, replication, Oracle migration, and more). Skills install on the AI agent, not on your MariaDB server.

What is a skill?

A skill is a curated markdown file the agent reads when a topic matches. Think of it as a briefing note: MariaDB-specific guidance, common LLM mistakes, and pointers to mariadb.com/docs.

Skills work with Claude Code, GitHub Copilot, Cursor, OpenAI Codex, and 20+ other tools. Learn more at agentskills.io and browse community skills at skills.sh.

Skills for MariaDB

We have created an initial set of eight skills at github.com/mariadb/skills — each for a different situation where agents need MariaDB-specific guidance. Install and usage instructions follow below.

Skills use wrong/right pairs, version annotations, and links to official documentation so agents can tailor advice to the MariaDB version you run.

mysql-to-mariadb

For developers migrating from MySQL, or where MySQL habits cause unexpected behavior in MariaDB. Covers authentication, JSON differences, GTID incompatibility with MySQL, and features MariaDB has that MySQL does not.

mariadb-features

For developers who want to use MariaDB well or evaluate a migration. System-versioned tables, RETURNING, sequences, instant DDL, native IP types, Oracle compatibility mode, Galera, ColumnStore, and more — the things agents rarely suggest unprompted.

oracle-to-mariadb

For developers migrating from Oracle Database. sql_mode=ORACLE, PL/SQL compatibility, data type mapping, what needs manual rewriting, and migration tools.

mariadb-query-optimization

For diagnosing slow queries and designing indexes. EXPLAIN, composite index rules, cursor-based pagination, histograms, and MariaDB-specific optimizer behavior.

mariadb-replication-and-ha

For replicated and HA setups — async replication, GTID, semi-sync, parallel replication, Galera Cluster, and application constraints that matter in production.

mariadb-system-versioned-tables

For automatic row history without triggers or audit tables — FOR SYSTEM_TIME queries, partitioning, and gotchas.

mariadb-vector