{{indexmenu_n>65}}
====== Скіли для AI-агента: робота з грою цілком ======

Сторінка [[uk:authors_main:task_editor:ai_authoring|про промпт]] — для чат-бота, який пише завдання в чаті. Ця — для **агента з доступом до файлів** (Claude Code, Codex, Cursor, Gemini CLI, Grok Build і подібні): він бере гру, вивантажену з редактора, розбирається в ній і править її — рівні, коди, бонуси, підказки, порядок завдань — не читаючи JSON руками, а через інструмент. Уміє й придумати рівень за довідником движка з прикладами з [[https://qeng.org/game.php?gid=3493|демо-гри]].

Скілів два:
  * **qeng-game-json** — читання та правка файлу гри: «що на рівні 5», «зміни автоперехід», «перестав рівень 7 на місце 3», «що не так у грі».
  * **qeng-game-author** — як писати рівень: довідник по движку, приклади з демо-гри, покрокові рецепти.

===== Як підключити: швидкий шлях =====

Дайте агенту посилання на цю сторінку й попросіть поставити скіли — далі він зробить усе сам за інструкцією в кінці сторінки: завантажить архів, розкладе скіли куди треба, перевірить версію. Потрібен лише Python 3.9 або новіший; якщо агент скаже, що його немає, встановіть з [[https://www.python.org/downloads/|python.org]].

Далі: у редакторі «Завантажити JSON» — цей файл ''game_N.json'' ви й віддаєте агентові. Назад — імпортом у редакторі: «Зберегти...» покаже список змін і помилки до запису.

===== Як підключити вручну =====

Архів з обома скілами: {{:authors_main:task_editor:qeng-game-skills.zip|qeng-game-skills.zip}}. Усередині дві теки, ''qeng-game-json'' і ''qeng-game-author''; покладіть обидві туди, де їх шукає ваш агент.

==== Claude Code ====
Теки — у ''.claude/skills/'' проєкту (лише для нього) або в ''~/.claude/skills/'' (для всіх проєктів). Новий скіл підхоплюється під час наступного запуску; викликати явно — ''/qeng-game-json''.

==== Codex, Cursor, Gemini CLI, Grok Build ====
Усі чотири читають одне й те саме місце: ''.agents/skills/'' проєкту або ''~/.agents/skills/'' у домашній теці.
  * **Codex** (CLI, розширення для IDE, застосунок): викликати явно — ''$qeng-game-json''.
  * **Cursor** — з версії 2.4; викликати явно — ''/qeng-game-json'' у чаті агента.
  * **Gemini CLI** спитає дозволу, перш ніж увімкнути скіл; список — ''gemini skills list''.
  * **Grok Build** (термінальний агент xAI): крім ''.agents/skills/'' читає й ''~/.grok/skills/''.

==== claude.ai ====
У claude.ai скіл завантажується в налаштуваннях, і **кожен своїм архівом**: {{:authors_main:task_editor:qeng-game-json.zip|qeng-game-json.zip}} і {{:authors_main:task_editor:qeng-game-author.zip|qeng-game-author.zip}}.
  - Увімкніть виконання коду: Settings → Capabilities. У Team і Enterprise це й скіли вмикає власник організації.
  - Customize → Skills → «+» → Create skill → Upload a skill — по черзі обидва архіви.
  - Файл гри прикріпіть до повідомлення в чаті; змінений Claude віддасть файлом для завантаження.

==== Інші агенти ====
Агент без підтримки скілів теж упорається, якщо має доступ до файлів і командного рядка: розпакуйте архів поруч із грою й попросіть агента прочитати ''qeng-game-json/SKILL.md'' і ''qeng-game-author/SKILL.md'' перед роботою. У чат-ботах без виконання коду (наприклад, у веб-чаті Grok) скіл не працює: інструментові потрібен Python.

===== Інструкція для агента =====

<code>
You are installing two skills for working with qeng.org games (version 0.1.0):
- qeng-game-json: read and edit a game export - the JSON the game editor downloads - as objects (levels, codes, bonuses, hints, lines), through a Python tool, never by opening the JSON;
- qeng-game-author: how a level is written - the engine's reference by topic, working levels of the demo game as examples, step-by-step recipes.

1. Requirement: Python 3.9 or newer (`python --version` or `python3 --version`). Nothing else: the tool uses only the standard library.
2. Download https://wiki.qeng.org/lib/exe/fetch.php?media=authors_main:task_editor:qeng-game-skills.zip and unpack it. It holds two folders, qeng-game-json/ and qeng-game-author/. Put both where your agent looks for skills:
   - Claude Code: .claude/skills/ of the project, or ~/.claude/skills/ for every project.
   - Codex, Cursor (2.4 or newer), Gemini CLI, Grok Build: .agents/skills/ of the project, or ~/.agents/skills/ for every project - all four read it.
   - Any other agent: anywhere; read qeng-game-json/SKILL.md and qeng-game-author/SKILL.md before working.
   Some agents load new skills only on the next start, or ask the user to approve a skill first (Gemini CLI).
3. Verify: `python qeng-game-json/qeng_game.py --version` (run from the skills folder) prints `qeng_game.py 0.1.0`. If this page names a newer version than the one installed, download again.
4. The game: the author downloads it in the game editor ("Download JSON", a file game_N.json) and gives it to you. Work on that file only with qeng_game.py - start with `python qeng-game-json/qeng_game.py --game game_N.json summary`, then `levels`. When done, the author imports the file back in the editor; "Save..." there lists every change and checks it before writing.
5. Translating a game is not part of these skills: the editor's "Translate" tab does that.

This page as plain text: https://wiki.qeng.org/doku.php?id=authors_main:task_editor:ai_agent&do=export_raw
</code>

<note tip>Переклад гри до скілів не входить — його робить вкладка «Переклад» редактора; див. [[uk:authors_main:game_management:localization|Локалізація гри]].</note>