skills

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #machine-learning #rust #docker #macos #java #cli #kubernetes #awesome-list #openai #open-source

(★ 11)

MariaDB skills for Claude Code and AI agents - because it is not MySQL

skills Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://mariadb.com/docs).

Skills work with Claude Code, GitHub Copilot, Cursor, OpenAI Codex, and 20+ other tools. Learn more at [agentskills.io](https://agentskills.io) and browse community skills at [skills.sh](https://www.skills.sh).

## Skills for MariaDB

We have created an initial set of eight skills at **[github.com/mariadb/skills](https://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](https://github.com/MariaDB/skills/blob/main/mysql-to-mariadb/SKILL.md)

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](https://github.com/MariaDB/skills/blob/main/mariadb-features/SKILL.md)

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](https://github.com/MariaDB/skills/blob/main/oracle-to-mariadb/SKILL.md)

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](https://github.com/MariaDB/skills/blob/main/mariadb-query-optimization/SKILL.md)

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

### [mariadb-replication-and-ha](https://github.com/MariaDB/skills/blob/main/mariadb-replication-and-ha/SKILL.md)

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](https://github.com/MariaDB/skills/blob/main/mariadb-system-versioned-tables/SKILL.md)

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

### [mariadb-vector](https://github.com/MariaDB/skills/blob/main/mariadb-vector/SKILL.md)

For AI applications, RAG, and semantic search. Native vector support since MariaDB 11.7 — no extension or plugin to install.

### [mariadb-mcp](https://github.com/MariaDB/skills/blob/main/mariadb-mcp/SKILL.md)

For connecting agents to a MariaDB database via the Model Context Protocol — schemas, read-only SQL, optional semantic search, and secure setup.

## How to install

### Interactive install with Node.js

Use [npx skills](https://github.com/vercel-labs/skills) for an interactive install — choose which MariaDB skills to install and which agents on your system (Claude, Cursor, Codex, etc.):

```
npx skills add mariadb/skills
```

Or install one skill:

```
npx skills add mariadb/skills/<skill-name>
```

Replace `<skill-name>` with e.g. `mariadb-vector` or `mysql-to-mariadb`. Installs are counted on [skills.sh](https://www.skills.sh).

### Installing without Node.js

Download `SKILL.md` into the agent's skill folder, for example:

```bash
mkdir -p ~/.claude/skills/<skill-name>
curl -o ~/.claude/skills/<skill-name>/SKILL.md \
  https://raw.githubusercontent.com/mariadb/skills/main/<skill-name>/SKILL.md
```

- Claude Code and Claude Desktop: `~/.claude/skills/<skill-name>/SKILL.md`
- OpenAI Codex: `~/.agents/skills/<skill-name>/SKILL.md`

### Updating installed skills

MariaDB skills may be updated over time. If you installed with `npx skills`, refresh your local copies periodically:

```
npx skills check
npx skills update
```

Run `check` first to see what's outdated; `update` pulls the latest from this repo. If you installed manually with `curl`, re-run the download commands above.

## Using MariaDB skills

Once installed, skills activate automatically. When your question matches a skill's topic, the agent reads it and applies the guidance for that session. No manual activation is needed.

## Contributions and Improvements

Open for improvements and more skills. Contributions and feedback welcome via pull requests.

skills

skills Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

skills

skills Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README