Скиллы для 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.

1. Включите выполнение кода: Settings → Capabilities. В Team и Enterprise это и скиллы включает владелец организации.
2. Customize → Skills → «+» → Create skill → Upload a skill — по очереди оба архива.
3. Файл игры прикрепите к сообщению в чате; изменённый 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>