Скіли для AI-агента: робота з грою цілком

Сторінка про промпт — для чат-бота, який пише завдання в чаті. Ця — для агента з доступом до файлів (Claude Code, Codex, Cursor, Gemini CLI, Grok Build і подібні): він бере гру, вивантажену з редактора, розбирається в ній і править її — рівні, коди, бонуси, підказки, порядок завдань — не читаючи JSON руками, а через інструмент. Уміє й придумати рівень за довідником движка з прикладами з демо-гри.

Скілів два:

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

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

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

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

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

Усі чотири читають одне й те саме місце: .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 скіл завантажується в налаштуваннях, і кожен своїм архівом: qeng-game-json.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.

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

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