mysql-to-percona

Plan migrations from MySQL or MariaDB to Percona Server for MySQL.

1|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/Percona-Lab/skills --skill mysql-to-percona
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mysql-to-percona
Source: https://github.com/Percona-Lab/skills/tree/main/mysql-to-percona
Command: npx skills add https://github.com/Percona-Lab/skills --skill mysql-to-percona

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through migrating from community MySQL or MariaDB to Percona Server for MySQL, including cross-major upgrades (8.0 to 8.4), ensuring a true binary drop-in replacement and awareness of 8.4 breaking changes.

Core Features & Use Cases

  • Provides a practical migration plan that preserves the datadir during same-major upgrades and explains when a dump/reload is necessary.
  • Highlights Percona-only features, plugins, and operational considerations that impact migration success.
  • Use Case: swapping a production MySQL 8.0/8.4 or MariaDB system to Percona Server with minimal downtime and verified compatibility.

Quick Start

Ask the agent to produce a cross-major upgrade plan from community MySQL or MariaDB to Percona Server for MySQL, covering 8.0 to 8.4 upgrade steps and breaking changes.

Frequently Asked Questions about mysql-to-percona

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

FAQPage Schema
How do I migrate MySQL to Percona Server while reusing the existing datadir?

To migrate MySQL to Percona Server while reusing the datadir, you can perform a package swap for same-major versions. This Skill provides a practical migration plan that preserves the datadir to minimize downtime during the transition.

What are the breaking changes when upgrading from MySQL 8.0 to 8.4?

Upgrading from MySQL 8.0 to 8.4 introduces breaking changes that require careful compatibility checks. This Skill guides you through the cross-major upgrade process, referencing official Percona Server 8.4 docs to address these breaking changes.

Can I swap MariaDB to Percona Server for MySQL as a direct binary drop-in replacement?

Swapping MariaDB to Percona Server for MySQL is supported as a binary drop-in replacement. This Skill helps you plan the migration by verifying compatibility and explaining when a dump and reload is necessary instead of a direct package swap.

When do I need a dump and reload instead of a package swap during a Percona Server migration?

A dump and reload is necessary during a Percona Server migration when performing cross-major upgrades that cannot preserve the datadir directly. This Skill identifies these scenarios to ensure data integrity and successful version transitions.

What Percona-only features and plugins should I consider after migrating from community MySQL?

After migrating from community MySQL, you can leverage Percona-only features, plugins, and operational enhancements. This Skill highlights these specific capabilities to optimize your database environment post-migration.

Does this migration process provide version guidance for Percona Server upgrades?

The migration process provides version guidance for Percona Server upgrades by referencing the percona-dk MCP. This ensures you receive accurate version-specific instructions and compatibility considerations for your target deployment.