mcpField
M
mysql

mysql

github.com/pageai-proData & databases33572 installsUpdated 18w ago
Repository

About mysql

A skill for planning and validating safe, measurable MySQL/InnoDB changes. It guides database developers through schema design, indexing, query tuning, locking, and operational rollout, with attention to evidence and rollback.

Key features

  1. 01Schema design guidance
  2. 02Index and partition planning
  3. 03Query optimization practices
  4. 04Transaction and locking advice
  5. 05Operational rollout and rollback

Use cases

  1. 01Designing a new OLTP table schema
  2. 02Investigating slow queries with EXPLAIN
  3. 03Planning production database changes safely

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pageai-pro/ralph-loop --skill mysql

After installing, type/mysqlin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
character-sets.md
composite-indexes.md
connection-management.md
covering-indexes.md
data-types.md
deadlocks.md
explain-analysis.md
fulltext-indexes.md
index-maintenance.md
isolation-levels.md
json-column-patterns.md
n-plus-one.md
online-ddl.md
partitioning.md
primary-keys.md
query-optimization-pitfalls.md
replication-lag.md
row-locking-gotchas.md

Details

From the project README

MySQL

Use this skill to make safe, measurable MySQL/InnoDB changes.

Workflow

  1. Define workload and constraints (read/write mix, latency target, data volume, MySQL version, hosting platform).
  2. Read only the relevant reference files linked in each section below.
  3. Propose the smallest change that can solve the problem, including trade-offs.
  4. Validate with evidence (EXPLAIN, EXPLAIN ANALYZE, lock/connection metrics, and production-safe rollout steps).
  5. 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. Prefer NOT NULL, DATETIME over TIMESTAMP.
  • 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 with count_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 MAXVALUE catch-all.

References:

Query Optimization

  • Check EXPLAIN — red flags: type: ALL, Using filesort, Using temporary.
  • Cursor pagination, not OFFSET. Avoid functions on indexed columns in WHERE.
  • Batch inserts (500–5000 rows). UNION ALL over UNION when dedup unnecessary.

References:

Transactions & Locking

  • Default: REPEATABLE READ (gap locks). Use READ COMMITTED for high contention.
  • Consistent row access order prevents deadlocks. Retry error 1213 with backoff.
  • Do I/O outside transactions. Use SELECT ... FOR UPDATE sparingly.

References:

Operations

  • Use online DDL (ALGORITHM=INPLACE) when possible; test on replicas first.
  • Tune connection pooling — avoid max_connections exhaustion 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).

Comments

Markdown supported