oxmysql — скилл для Claude Code: что делает и как установить
Скилл для Claude Code помогает писать серверный SQL-код для FiveM через oxmysql. Включается при работе с запросами к базе данных и миграции с mysql-async.
MIT 124 установок ★ 20 обновлён 2026-10-17
npx skills add germanfndez/fiveai-skills --skill oxmysql -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/oxmysql/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/oxmysql/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill oxmysql -a codex2Вручную: положить файлы
.agents/skills/oxmysql/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill oxmysql -a cursor2Вручную: положить файлы
.cursor/skills/oxmysql/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install germanfndez/fiveai-skills skills/oxmysql2Вручную: положить файлы
.github/skills/oxmysql/SKILL.md1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill oxmysql -a gemini-cli2Командой платформы
gemini skills install https://github.com/germanfndez/fiveai-skills --path skills/oxmysqlВручную: положить файлы
.devin/skills/oxmysql/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill oxmysql -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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