К основному содержанию
скилл CX Codex

oxmysql — скилл для Claude Code: что делает и как установить

Скилл для Claude Code помогает писать серверный SQL-код для FiveM через oxmysql. Включается при работе с запросами к базе данных и миграции с mysql-async.

MIT 124 установок ★ 20 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add germanfndez/fiveai-skills --skill oxmysql -a claude-code
Открыть на GitHub

Что делает oxmysql

Скилл подбирает вызов oxmysql по нужному результату запроса и генерирует серверный Lua- или JavaScript-код с .await и позиционными плейсхолдерами ?. Он охватывает чтение и изменение данных, подготовленные запросы и транзакции. Пользовательские значения передаются через плейсхолдеры, а не вставляются в SQL-строку.

В fxmanifest.lua нужно добавить server_script '@oxmysql/lib/MySQL.lua' выше остальных серверных скриптов; oxmysql должен запускаться раньше ресурса. MySQL.Sync.* и MySQL.Async.* не поддерживаются. Для нескольких записей, которые должны пройти вместе, скилл использует транзакцию с откатом при ошибке.

Какие задачи решает

  • написать SELECT-запрос с параметрами для FiveM
  • получить одну строку или значение из базы
  • сгруппировать несколько записей в транзакцию
  • переписать вызовы mysql-async на oxmysql

Примеры запросов агенту

  • Напиши серверный Lua-код для поиска игрока через MySQL.single.await с параметром ?.
  • Перепиши этот запрос с mysql-async на oxmysql.
  • Сохрани несколько изменений в базе одной транзакцией oxmysql.

Как установить oxmysql

1Через Skills CLI (Vercel)

npx skills add germanfndez/fiveai-skills --skill oxmysql -a claude-code

2Вручную: положить файлы

~/.claude/skills/oxmysql/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/oxmysql/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об oxmysql

Как установить oxmysql в Claude Code?

Выполни npx skills add germanfndez/fiveai-skills --skill oxmysql -a claude-code. Файл скилла появится по пути ~/.claude/skills/oxmysql/SKILL.md.

Что делает oxmysql?

Скилл помогает писать серверный SQL-код для FiveM через oxmysql. Он подбирает функцию для формы результата и использует .await с плейсхолдерами ?.

Что нужно для работы oxmysql?

Нужен ресурс oxmysql, который запускается раньше FiveM-ресурса с кодом. В fxmanifest.lua добавляется строка server_script '@oxmysql/lib/MySQL.lua'.

Исходный текст

SKILL.md · MIT
---
name: oxmysql
description: "Trigger: oxmysql, MySQL.query, MySQL.insert, MySQL.update, MySQL.single, MySQL.scalar, MySQL.prepare, MySQL.transaction, rawExecute, SQL, database, mysql-async. Write server-side SQL with oxmysql."
license: MIT
metadata:
  author: germanfndez
  version: "1.0.0"
---

# oxmysql

Server-side MySQL/MariaDB access for FiveM through the `MySQL` table (replacement for mysql-async and ghmattimysql).

## Activation Contract

Load this skill when the user writes or edits database code in a FiveM resource: SELECT/INSERT/UPDATE/DELETE, upserts, transactions, `MySQL.*`, `exports.oxmysql`, or migrating from mysql-async.

## Hard Rules

- Server only. Add `server_script '@oxmysql/lib/MySQL.lua'` to `fxmanifest.lua` above other server scripts.
- `MySQL.Sync.*` and `MySQL.Async.*` (mysql-async compatibility layer) are NOT available. Replace them with `MySQL.query`, `MySQL.scalar`, `MySQL.single`, `MySQL.insert`, `MySQL.update`, `MySQL.prepare`, `MySQL.transaction`, each with a `.await` variant.
- `@named` placeholders are deprecated: use positional `?` with an array of values. `prepare` accepts only `?` (and `??` for column names).
- Never concatenate user input into SQL; every value goes through a placeholder.
- Every function takes `(query, params, callback)`; use `.await` to yield instead of nesting callbacks.
- Use `transaction` when several writes must succeed or fail together; it rolls back on any failure.
- Use `rawExecute` only when the normalized result shape of `query`/`prepare` is insufficient.
- Prefer MariaDB over MySQL 8 for compatibility.

## Decision Gates

| Need | Call | Returns |
|---|---|---|
| Many rows | `MySQL.query.await(sql, params)` | array of rows |
| One row | `MySQL.single.await(sql, params)` | row or nil |
| One value (COUNT, one column) | `MySQL.scalar.await(sql, params)` | value or nil |
| Insert | `MySQL.insert.await(sql, params)` | insert id |
| Update / delete count | `MySQL.update.await(sql, params)` | affected rows |
| Hot path, repeated statement | `MySQL.prepare.await(sql, params)` | rows / value |
| Several statements atomically | `MySQL.transaction.await({ { query, values }, ... })` | success boolean |
| Raw, unnormalized result | `MySQL.rawExecute.await(sql, params)` | raw result |

## Execution Steps

1. Confirm the manifest line and that `oxmysql` starts before the resource.
2. Pick the function by result shape from Decision Gates.
3. Write the SQL with backticked identifiers and `?` for every value.
4. Wrap multi-statement writes in `transaction`.
5. Handle nil results (`single`, `scalar`) before use.

## Output Contract

Return runnable server-side Lua (or JS) using `MySQL.<fn>.await` with positional placeholders and no mysql-async syntax.

## References

- rules/placeholders.md — `?` placeholders, deprecated `@named`.
- rules/query.md — MySQL.query: rows or insertId/affectedRows.
- rules/single.md — MySQL.single: one row or nil.
- rules/scalar.md — MySQL.scalar: single value.
- rules/insert.md — MySQL.insert: returns insert id.
- rules/update.md — MySQL.update: returns affected rows.
- rules/prepare.md — MySQL.prepare: prepared statements.
- rules/transaction.md — MySQL.transaction: atomic multi-query.
- rules/rawExecute.md — MySQL.rawExecute: raw result.

Upstream docs: https://overextended.dev/oxmysql

© germanfndez · MIT · germanfndez/fiveai-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
fivem-dev melihbozkurt10 Скилл fivem-dev ведёт разработку ресурсов FiveM под QBox, QBCore и ESX: подтягивает нативы, API фреймворков и модели ассетов вместо догадок. CX Codex +1 521установок sql-pro https://github.com/Jeffallan Скилл sql-pro оптимизирует медленные SQL-запросы, проектирует схемы баз данных и устраняет проблемы производительности. Пригодится при разборе планов EXPLAIN и миграции диалектов. CX Codex +1 6 900установок database-optimizer https://github.com/Jeffallan Скилл database-optimizer помогает находить узкие места в PostgreSQL и MySQL, разбирать планы выполнения через EXPLAIN ANALYZE и настраивать индексы без простоя таблиц. CX Codex +1 6 500установок mysql-patterns affaan-m Скилл mysql-patterns с проверенными шаблонами для MySQL и MariaDB. Помогает проектировать схемы, настраивать индексы и ускорять медленные транзакции. CX Codex +1 6 400установок sql-queries phuryn Скилл sql-queries генерирует SQL-запросы по описанию на естественном языке с учётом схемы базы. Помогает аналитикам и разработчикам собирать отчёты и переводить бизнес-задачи в код. CX Codex +1 3 000установок mysql-best-practices Mindrally Скилл mysql-best-practices для Claude Code помогает агентам проектировать схемы MySQL, строить индексы и писать запросы без типичных ошибок. Охватывает выбор движка, типы данных, EXPLAIN-анализ и транзакции. CX Codex +1 2 800установок

Из того же набора12

Весь набор →
lua-basics Скилл lua-basics задаёт ИИ-агенту стиль Lua-кода для ресурсов FiveM: именование, локальные переменные, таблицы и обработка ошибок. CX Codex +1 436установок fivemanage Скилл учит агента работать с SDK Fivemanage: снимать скриншоты игроков, загружать картинки и отправлять логи в дашборд через exports.fmsdk. CX Codex +1 367установок esx-framework Скилл esx-framework ведёт агента по API ESX Legacy для ресурсов FiveM: сервер и клиент, xPlayer, PlayerData, колбэки, работы и деньги. CX Codex +1 319установок qbcore-framework Скилл qbcore-framework помогает создавать ресурсы FiveM для qb-core, генерируя серверный и клиентский код на Lua с проверками аргументов и правильной работой с объектом Player. CX Codex +1 272установок oxlib Помогает писать Lua-код для ox_lib в ресурсах FiveM. Подключается при работе с интерфейсом, зонами, командами или обменом данными между клиентом и сервером. CX Codex +1 117установок fivem-deployment Скилл fivem-deployment для Claude Code подбирает и проверяет сборки FXServer. Включается при обновлении сервера, настройке server.cfg или поиске причины, по которой клиенты не подключаются. CX Codex +1 114установок ox-inventory Помогает писать Lua-код для ox_inventory: управлять предметами, тайниками, магазинами и реакциями на действия игроков. CX Codex +1 104установок ox-target Помогает добавлять взаимодействия в FiveM через ox_target. Активируется при создании третьего глаза, зон и целевых объектов или миграции с qb-target. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой