# fivem-nui

Скилл fivem-nui для сборки HTML/CSS/JS-интерфейсов в FiveM-ресурсах: манифест, обмен сообщениями между Lua и браузером, коллбэки и фокус.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 649 установок · ★ 20 у репозитория
- Автор: germanfndez
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/germanfndez/fiveai-skills/tree/HEAD/skills/fivem-nui/SKILL.md
- Обновлён: 2026-10-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/fivem-nui

## Что делает

Агент собирает `ui_page`, декларирует файлы в `fxmanifest.lua`, связывает Lua-клиент с браузером через `SendNUIMessage` и `RegisterNUICallback`, управляет фокусом клавиатуры и мыши. Внутри скилла — правила по структуре манифеста, обработке коллбэков, валидации данных на сервере и отладке через F8 и Chrome DevTools.

Каждый коллбэк `RegisterNUICallback` обязан вызвать `cb(...)` на любом пути выполнения, иначе запрос браузера зависнет. Логику изменения состояния, суммы, цены и id агент переносит на сервер, а не оставляет в NUI: данные из браузера приходят на клиент, клиент пересылает их серверу, сервер валидирует заново. Скилл загружается, когда упомянут `SendNUIMessage`, `SetNUIFocus` или `RegisterNUICallback`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add germanfndez/fiveai-skills --skill fivem-nui -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/fivem-nui/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/fivem-nui/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add germanfndez/fiveai-skills --skill fivem-nui -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/fivem-nui/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add germanfndez/fiveai-skills --skill fivem-nui -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/fivem-nui/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install germanfndez/fiveai-skills skills/fivem-nui
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/fivem-nui/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add germanfndez/fiveai-skills --skill fivem-nui -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/germanfndez/fiveai-skills --path skills/fivem-nui
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/fivem-nui/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add germanfndez/fiveai-skills --skill fivem-nui -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/germanfndez/fiveai-skills/tree/HEAD/skills/fivem-nui/SKILL.md

## Когда брать
- собрать HTML/CSS/JS-интерфейс для FiveM-ресурса
- связать Lua-клиент с браузером через `SendNUIMessage` и `RegisterNUICallback`
- объявить `ui_page` и файлы в `fxmanifest.lua`
- управлять фокусом клавиатуры и мыши в NUI
- валидировать данные из браузера на сервере

## Примеры запросов агенту
- Сделай NUI-меню для открытия магазина, кнопки слева, на закрытие по Escape
- Добавь `ui_page` в манифест и зарегистрируй коллбэк `buyItem`
- Покажи, как отправить сообщение из Lua в браузер через `SendNUIMessage`

## Похожие
- [fivem-dev](https://affpapa.org/nevibecode/skills/fivem-dev.md) — скилл · 521 установка
- [FiveM MCP](https://affpapa.org/nevibecode/mcp/fivem-mcp.md) — MCP-сервер · ★ 20 у репозитория
- [modern-web-guidance](https://affpapa.org/nevibecode/skills/modern-web-guidance.md) — скилл · 62500 установок
- [frontend-slides](https://affpapa.org/nevibecode/skills/frontend-slides.md) — скилл · 7300 установок
- [bootstrap-v5-v6-migration](https://affpapa.org/nevibecode/skills/bootstrap-v5-v6-migration.md) — скилл · 667 установок
- [generic-static-code-reviewer](https://affpapa.org/nevibecode/skills/generic-static-code-reviewer.md) — скилл · 149 установок

Из того же набора: [germanfndez/fiveai-skills](https://affpapa.org/nevibecode/by/germanfndez/fiveai-skills.md) — 12 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
