fivemanage — скилл для Claude Code: скриншоты и логи FiveM
Скилл учит агента работать с SDK Fivemanage: снимать скриншоты игроков, загружать картинки и отправлять логи в дашборд через exports.fmsdk.
npx skills add germanfndez/fiveai-skills --skill fivemanage -a claude-codeЧто делает fivemanage
Скилл включается, когда в проекте ставится или настраивается Fivemanage SDK, когда нужен скриншот игрока или запись в централизованный лог. Агент держит перед глазами таблицу выбора вызова: takeImage работает на клиенте, takeServerImage(playerSource, ...) и uploadImage(buffer, ...) — на сервере. Для логов есть Log(dataset, level, message, metadata) с явным уровнем и короткие обёртки Info/Warn/Error; LogMessage считается устаревшим.
Перед установкой придётся разобраться с порядком. Папка ресурса должна называться fmsdk и лежать прямо в resources/ — вложенные категории не поддерживаются. Для takeImage и takeServerImage нужен screenshot-basic, причём его ensure идёт в server.cfg раньше fmsdk. Если перепутать порядок, скриншоты просто не снимутся. Ключи API задаются ConVars в server.cfg (FIVEMANAGE_MEDIA_API_KEY, FIVEMANAGE_LOGS_API_KEY), а не в config.json, и включать стоит только те, что нужны для используемых функций.
Внутри скилла — правила по установке, картинкам, логам и config.json с автоматическими событиями. Агент возвращает строки для server.cfg, а затем рабочий код на Lua или JS с явно указанной стороной вызова. В метаданные советует добавлять playerSource или targetSource, чтобы SDK сам подтянул идентификаторы игрока, и завести отдельный dataset под каждую тему: economy, anticheat, admin_actions. Токены API в NUI отдавать нельзя — для клиентской загрузки предусмотрены presigned URL.
Какие задачи решает
- снять скриншот экрана игрока по команде администратора
- загрузить готовый буфер изображения в Fivemanage
- отправить лог с уровнем в дашборд из Lua или JS
- разложить логи по датасетам вроде economy и anticheat
- включить автоматические события чата и ресурсов через config.json
Примеры запросов агенту
- Поставь fmsdk и покажи строки для server.cfg с ключами API
- Сделай серверный скриншот игрока через takeServerImage и приложи playerSource
- Настрой отправку логов в датасет admin_actions через exports.fmsdk:Log
Как установить fivemanage
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill fivemanage -a claude-code2Вручную: положить файлы
~/.claude/skills/fivemanage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/fivemanage/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill fivemanage -a codex2Вручную: положить файлы
.agents/skills/fivemanage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill fivemanage -a cursor2Вручную: положить файлы
.cursor/skills/fivemanage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install germanfndez/fiveai-skills fivemanage2Вручную: положить файлы
.github/skills/fivemanage/SKILL.md1Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill fivemanage -a gemini-cli2Командой платформы
gemini skills install https://github.com/germanfndez/fiveai-skills --path skills/fivemanageВручную: положить файлы
.devin/skills/fivemanage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add germanfndez/fiveai-skills --skill fivemanage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о fivemanage
Как установить fivemanage в Claude?
Выполните npx skills add germanfndez/fiveai-skills --skill fivemanage -a claude-code. Файл скилла окажется по пути ~/.claude/skills/fivemanage/SKILL.md.
Что делает скилл fivemanage?
Он подсказывает агенту, как ставить и использовать Fivemanage SDK для FiveM: снимать скриншоты, загружать изображения и писать логи в дашборд через exports.fmsdk.
Что нужно для работы takeImage и takeServerImage?
Ресурс screenshot-basic, причём его ensure должен стоять в server.cfg раньше fmsdk. Папка самого ресурса называется fmsdk и лежит прямо в resources/.
Исходный текст
SKILL.md · MIT
---
name: fivemanage
description: "Trigger: Fivemanage, fmsdk, takeImage, takeServerImage, uploadImage, Log, Info/Warn/Error, player screenshots, logs dashboard. Install and use the Fivemanage SDK for images and centralized logs."
license: MIT
metadata:
author: germanfndez
version: "1.0.0"
---
# Fivemanage SDK
Screenshots, image uploads and centralized logs for FiveM through `exports.fmsdk`.
## Activation Contract
Load this skill when the user installs or configures the Fivemanage SDK, captures or uploads player screenshots, sends logs to the Fivemanage dashboard, or calls any `exports.fmsdk` function in Lua or JavaScript.
## Hard Rules
- The resource folder must be named `fmsdk` and sit directly in `resources/`; category folders are not supported.
- `screenshot-basic` is required for `takeImage` / `takeServerImage` and must `ensure` BEFORE `fmsdk` in `server.cfg`.
- API keys are ConVars in `server.cfg` (`FIVEMANAGE_MEDIA_API_KEY`, `FIVEMANAGE_LOGS_API_KEY`), never in `config.json`. Set only the keys for the features used.
- `takeImage` is CLIENT-side; `takeServerImage(playerSource, ...)` and `uploadImage(buffer, ...)` are SERVER-side.
- `Log(dataset, level, message, metadata)` is the primary log export; `Info/Warn/Error(dataset, message, metadata)` are fixed-level shorthands. `LogMessage` is legacy.
- Include `playerSource` / `targetSource` in metadata so the SDK attaches player identifiers automatically.
- Never expose API tokens to NUI; use presigned URLs for client-side uploads.
## Decision Gates
| Need | Call |
|---|---|
| Screenshot from the player's own client | `exports.fmsdk:takeImage({ ... })` |
| Screenshot of a player from the server | `exports.fmsdk:takeServerImage(playerSource, { ... })` |
| Upload an existing image file/buffer | `exports.fmsdk:uploadImage(buffer, { ... })` |
| Log with explicit level | `exports.fmsdk:Log(dataset, level, message, metadata)` |
| Quick log | `exports.fmsdk:Info/Warn/Error(dataset, message, metadata)` |
| Automatic player/chat/resource logs | `config.json` inside `fmsdk` |
## Execution Steps
1. Verify install order and ConVars (read rules/installation.md).
2. Pick the side and export from Decision Gates.
3. Attach metadata (`name`, `description`, `playerSource`) so entries are searchable.
4. Choose a dataset per concern (`economy`, `anticheat`, `admin_actions`).
5. Enable automatic events in `config.json` when useful (read rules/configuration.md).
## Output Contract
Return the `server.cfg` lines when installing, then runnable Lua or JS using `exports.fmsdk` with the side explicit and metadata included.
## References
- rules/installation.md — download, folder placement, server.cfg order, API keys.
- rules/images.md — takeImage, takeServerImage, uploadImage, metadata.
- rules/logs.md — Log, Info/Warn/Error, LogMessage, datasets, identifiers.
- rules/configuration.md — config.json, automatic events, presigned URLs.
- rules/reference-links.md — official docs and SDK download.
Upstream docs: https://docs.fivemanage.com/fivem-sdk/installation
© germanfndez · MIT · germanfndez/fiveai-skills
