mysql
Plan and review MySQL/InnoDB schema, indexing, query tuning, transactions, and operations. Use when creating or modifying MySQL tables, indexes, or queries; diagnosing slow/locking behavior; planning migrations; or troubleshooting replication and connection issues. Load when using a MySQL database.
- Installs
- 72
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/pageai-pro/ralph-loop --skill mysql- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads mysql automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
MySQL
Use this skill to make safe, measurable MySQL/InnoDB changes.
Workflow
- Define workload and constraints (read/write mix, latency target, data volume, MySQL version, hosting platform).
- Read only the relevant reference files linked in each section below.
- Propose the smallest change that can solve the problem, including trade-offs.
- Validate with evidence (
EXPLAIN,EXPLAIN ANALYZE, lock/connection metrics, and production-safe rollout steps). - For production changes, include rollback and post-deploy verification.
Schema Design
- Prefer narrow, monotonic PKs (
BIGINT UNSIGNED AUTO_INCREMENT) for write-heavy OLTP tables. - Avoid random UUID values as clustered PKs; if external IDs are required, keep UUID in a secondary unique column.
- Always
utf8mb4/utf8mb4_0900_ai_ci. PreferNOT NULL,DATETIMEoverTIMESTAMP. - Lookup tables over
ENUM. Normalize to 3NF; denormalize only for measured hot paths.
References:
Indexing
- Composite order: equality first, then range/sort (leftmost prefix rule).
- Range predicates stop index usage for subsequent columns.
- Secondary indexes include PK implicitly. Prefix indexes for long strings.
- Audit via
performance_schema— drop indexes withcount_read = 0.
References:
Partitioning
- Partition time-series (>50M rows) or large tables (>100M rows). Plan early — retrofit = full rebuild.
- Include partition column in every unique/PK. Always add a
MAXVALUEcatch-all.
References:
Query Optimization
- Check
EXPLAIN— red flags:type: ALL,Using filesort,Using temporary. - Cursor pagination, not
OFFSET. Avoid functions on indexed columns inWHERE. - Batch inserts (500–5000 rows).
UNION ALLoverUNIONwhen dedup unnecessary.
References:
Transactions & Locking
- Default:
REPEATABLE READ(gap locks). UseREAD COMMITTEDfor high contention. - Consistent row access order prevents deadlocks. Retry error 1213 with backoff.
- Do I/O outside transactions. Use
SELECT ... FOR UPDATEsparingly.
References:
Operations
- Use online DDL (
ALGORITHM=INPLACE) when possible; test on replicas first. - Tune connection pooling — avoid
max_connectionsexhaustion under load. - Monitor replication lag; avoid stale reads from replicas during writes.
References:
Guardrails
- Prefer measured evidence over blanket rules of thumb.
- Note MySQL-version-specific behavior when giving advice.
- Ask for explicit human approval before destructive data operations (drops/deletes/truncates).
FAQ
What does the mysql skill do?
Plan and review MySQL/InnoDB schema, indexing, query tuning, transactions, and operations. Use when creating or modifying MySQL tables, indexes, or queries; diagnosing slow/locking behavior; planning migrations; or troubleshooting replication and connection issues. Load when using a MySQL database.
How do I install mysql?
Run npx skills add https://github.com/pageai-pro/ralph-loop --skill mysql in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/mysql/ (personal) or .claude/skills/mysql/ (project).
Which AI agents can use mysql?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is mysql safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains mysql?
It is published by pageai-pro in pageai-pro/ralph-loop. It has 72 recorded installs.
More from pageai-pro/ralph-loop
prd-creator
pageai-pro/ralph-loop
Guides creation of comprehensive Product Requirement Documents (PRDs) for software projects through structured questioning and validation, then generates implementation task lists in JSON format. Use when users want to document a software idea, create specifications for development, plan a new application feature/bug, or break down requirements into actionable tasks. Transforms ideas into implementation-ready documents with verifiable pass criteria.
vitest-best-practices
pageai-pro/ralph-loop
Comprehensive vitest testing patterns covering test structure, AAA pattern, parameterized tests, assertions, mocking, test doubles, error handling, async testing, and performance optimization. Use when writing, reviewing, or refactoring vitest tests, or when user mentions vitest, testing, TDD, test coverage, mocking, assertions, or test files (.test.ts, .spec.ts).
e2e-tester
pageai-pro/ralph-loop
Open the skill to read its SKILL.md instructions.
frontend-code-review
pageai-pro/ralph-loop
Trigger when the user requests a review of frontend files (e.g., .tsx, .ts, .js). Support both pending-change reviews and focused file reviews while applying the checklist rules.
component-refactoring
pageai-pro/ralph-loop
Refactor high-complexity React components in frontend. Use when the user asks for code splitting, hook extraction, or complexity reduction, or when you come across a component that is too complex to understand and refactor it.
frontend-testing
pageai-pro/ralph-loop
Generate Vitest + React Testing Library tests for frontend components, hooks, and utilities. Triggers on testing, spec files, coverage, Vitest, RTL, unit tests, integration tests, or write/review test requests.
Popular data & databases skills
supabase-postgres-best-practices
supabase/agent-skills
Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pgcron, pgmq), vector/semantic search (pgvector), and restoring dumps (pgrestore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query.
prisma-client-api
prisma/skills
Prisma Client API reference covering model queries, filters, operators, and client methods. Use when writing database queries, using CRUD operations, filtering data, or configuring Prisma Client. Triggers on "prisma query", "findMany", "create", "update", "delete", "$transaction".
prisma-database-setup
prisma/skills
Deprecated compatibility name for prisma-orm-setup. Use only when a user or existing integration explicitly invokes prisma-database-setup; otherwise select prisma-orm-setup.
prisma-cli
prisma/skills
Prisma ORM 7 CLI reference for existing Prisma 7 applications or explicitly selected Prisma 7 workflows. Covers prisma init, generate, migrate, db, dev, studio, and mcp. For setup, connection repair, or Prisma 8, use prisma-orm-setup; not the Prisma Platform CLI.
prisma-postgres
prisma/skills
Deprecated compatibility name for prisma-postgres-setup. Use only when a user or existing integration explicitly invokes prisma-postgres; otherwise select prisma-postgres-setup.
prisma-driver-adapter-implementation
prisma/skills
Required reference for Prisma ORM 7 SQL driver adapter work. Use when implementing or modifying adapters, adding database drivers, or touching SqlDriverAdapter, Transaction, savepoint, result mapping, or DriverAdapterError behavior. Covers current transaction lifecycle, optional savepoint hooks, original database-error preservation, and verification.