Agent Skills для геймдева: установка в Claude Code, Codex и Cursor
Установите awesome-gamedev-agent-skills в проект, найдите файлы навыков в Claude Code, Codex и Cursor и проверьте, какие инструкции читает маршрутизатор. Разберитесь с набором из 76 специализированных навыков и отдельного router, загрузкой контекста, проверками для Godot и Unity и разрешениями сторонних навыков.
Содержание
Установите gamedev-skills/awesome-gamedev-agent-skills из корня игрового проекта командой npx skills add gamedev-skills/awesome-gamedev-agent-skills: включите в набор router и выберите своего агента для программирования. Затем явно вызовите этот навык и проверьте небольшое изменение в Godot или Unity, прежде чем поручать агенту большую задачу. Полный набор можно держать установленным без загрузки всех инструкций в контекст: сначала агент получает метаданные, а содержимое выбранных навыков читает по мере необходимости.
По состоянию на 2026-10-26 в репозитории проекта находятся 76 специализированных навыков и отдельный router — всего 77 навыков, если считать маршрутизатор. В описании About всё ещё указано 74; при установке ориентируйтесь на текущие файлы и предварительный список установщика. Набор распространяется под лицензией Apache-2.0.
Такой набор пригодится, если вы уже работаете с агентом для программирования и хотите дать ему готовые инструкции по конкретному движку. Он помогает организовать работу с кодом и проектом; игровой редактор, сам проект и действующая учётная запись агента либо настроенное подключение к API по-прежнему нужны отдельно.
Установите набор в текущий проект
Начните с установки на уровне проекта: так добавленные файлы можно проверить вместе с остальным кодом игры. На 2026-10-26 опубликованная версия утилиты skills — 1.7.4; согласно метаданным npm, ей нужна Node.js 22.20.0 или новее. Для получения репозитория также должен быть доступен Git.
Откройте Bash в корне игрового проекта и посмотрите список доступных навыков:
node --version
git --version
npx skills add gamedev-skills/awesome-gamedev-agent-skills --listНайдите в списке router, godot-2d-movement, platformer и unity-scriptableobjects. Параметр --list выводит доступные навыки без их установки. Прочитайте инструкции маршрутизатора и тех навыков, которыми собираетесь пользоваться, прежде чем подтверждать установку.
Выполните команду из инструкции к набору:
npx skills add gamedev-skills/awesome-gamedev-agent-skillsДля этого руководства выберите в интерактивном меню весь набор вместе с маршрутизатором, укажите своего агента и область установки Project — текущий проект. Добавляйте -g, только если хотите установить навыки в пользовательский каталог для использования во всех проектах.
Чтобы явно выбрать все навыки для Codex, можно использовать такую команду:
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill '*' -a codexДля других клиентов замените codex на claude-code или cursor. Сохраните кавычки вокруг '*', чтобы Bash не подставил вместо звёздочки имена файлов. В справочнике CLI эти варианты различаются: --skill '*' выбирает все навыки, а --all дополнительно выбирает всех агентов.
Проверьте результат:
npx skills listВ списке должны быть router и навыки для выбранной ниже проверки движка. Установщик получает общедоступные файлы инструкций; авторизация для работы с моделью остаётся в вашем клиенте. Запросы агента по-прежнему расходуют обычный лимит использования модели или оплачиваются по API.
Где Claude Code, Codex и Cursor ищут установленные навыки?
Проверяйте фактический путь установки: каталоги, которые поддерживает клиент, не всегда совпадают с каталогом, который выбирает CLI. При установке в проект через skills 1.7.4 используются следующие пути:
| Агент | Значение после -a | Каталог установки в проекте | Как явно вызвать router в чате |
|---|---|---|---|
| Claude Code | claude-code | .claude/skills/ | /router |
| Codex CLI или расширение для IDE | codex | .agents/skills/ | Выберите router через /skills или укажите $router |
| Cursor Agent | cursor | .agents/skills/ | Введите / и выберите router |
Команды из последнего столбца вводятся в чате агента, а не в Bash. Cursor также поддерживает .cursor/skills/ для ручной установки. Поэтому краткая страница установки набора полезна как перечень совместимых каталогов, но пустая папка .cursor/skills/ сама по себе не означает, что установка через CLI не удалась.
В текущем списке путей установщика и Codex, и Cursor используют .agents/skills/. Если выбранные клиенты используют один каталог назначения, установщик копирует туда файлы. Для клиентов с разными каталогами можно использовать общую копию в .agents/skills/ с символическими ссылками либо отдельные копии. Проверьте сводку установки: символические ссылки создаются не во всех случаях.
У каждого установленного навыка должен быть файл по схеме <skills-directory>/<skill-name>/SKILL.md. Например, навык движения для Codex находится в .agents/skills/godot-2d-movement/SKILL.md, а соответствующая запись для Claude Code — в .claude/skills/godot-2d-movement/SKILL.md. Если внутри навыка есть каталоги references/, scripts/ и assets/, сохраняйте их вместе с основным файлом, как указано в инструкции по ручной установке.
Как router выбирает нужные навыки?
Маршрутизатор выбирает инструкции по движку и задаче, а загрузку по мере необходимости обеспечивает сам агент. В обзоре стандарта Agent Skills описаны три этапа: сначала агент узнаёт о навыках по названиям и описаниям, затем читает основной текст выбранного навыка, а при выполнении задачи обращается к дополнительным материалам.
В инструкциях router этот механизм применяется к разработке игр:
- Определить один движок по файлам проекта и выяснить его версию.
- Подобрать минимальный набор навыков для движка, технической задачи, жанра и этапа работы.
- Прочитать выбранные инструкции, а вложенные справочные материалы открывать только по необходимости.
Для Godot основной признак — файл project.godot. Для Unity — сочетание каталога Assets/ и файла ProjectSettings/ProjectVersion.txt. Запрос на изменение движения может привести к выбору godot-2d-movement и platformer. Если следующая задача касается сохранений, агенту следует выбрать соответствующие инструкции по хранению состояния, а не загружать каталоги других движков.
Сам router — это инструкция в SKILL.md, которой следует модель. Он не является отдельной программой, жёстко ограничивающей число прочитанных файлов. Установка одного лишь маршрутизатора тоже не даёт доступа ко всем инструкциям, на которые он ссылается: нужные специализированные навыки должны быть установлены и доступны агенту.
Метаданные занимают место в контексте, а загруженные инструкции, результаты инструментов и повторные попытки продолжают расходовать доступный лимит или бюджет. Если из-за большого набора появляются предупреждения о лимите контекста для списка навыков, используйте --skill и оставьте маршрутизатор вместе с нужными для вашей работы навыками. Из одного лишь количества навыков нельзя вывести подтверждённый процент экономии токенов.
Проверьте настройку на небольшой задаче
Проверьте два результата: агент прочитал нужные инструкции, а внесённое изменение работает в движке. Начните новый сеанс в игровом проекте, явно выберите маршрутизатор способом из таблицы выше и отправьте один из следующих запросов.
Если клиент показывает обращения к инструментам, найдите фактический вызов навыка или чтение его файлов. Успешное чтение установленного SKILL.md надёжнее подтверждает загрузку, чем сообщение агента «навык загружен».
Godot: добавьте дополнительный прыжок в воздухе
Используйте существующую рабочую сцену Godot 4 с игроком на CharacterBody2D, формой коллизии и полом. Для такого запроса маршрутизатор предусматривает сочетание godot-2d-movement и platformer; навык движения содержит инструкции по реализации контроллера в этом движке.
Use the installed router skill for this Godot project. Inspect project.godot
and the actual editor version before editing, and preserve that version.
Report the resolved paths of the router and selected SKILL.md files you
actually read. Resolve skill names through the installed skill locations.
Add one extra mid-air jump to the existing CharacterBody2D player.
Keep the change in the player controller and preserve the current controls.
A fresh jump press on the ground starts the first jump. One more fresh
press in the air starts the second. A third press before landing does
nothing. Holding the button must not repeatedly jump. Landing restores
both jumps.
List the changed files and give the exact scene and controls for checking
the result. Separate checks you ran from checks I must perform in Godot.Запустите указанную агентом сцену. Два отдельных нажатия должны дать два прыжка, третье нажатие в воздухе — не вызывать новый прыжок, а приземление — восстанавливать возможность повторить последовательность. Отдельно удерживайте кнопку во время прыжка: это не должно вызывать серию повторных прыжков. Проверьте, что не появилось новых ошибок в скриптах и во время выполнения.
Навык движения ориентирован на Godot 4.7, однако инструкция по определению движка требует сохранять версию существующего проекта. Установка набора сама по себе не повод обновлять проект или использовать API из другой версии.
Unity: разделите общие данные и состояние объектов
Возьмите отдельную тестовую сцену в существующем проекте Unity. Основной навык для этой проверки — unity-scriptableobjects; unity-csharp-scripting подходит для небольшого компонента, который использует эти данные. Так можно проверить рекомендации по общим данным, не заказывая целую систему инвентаря.
Use the installed router skill for this Unity project. Read
ProjectSettings/ProjectVersion.txt and preserve the editor and package
versions. Report the resolved SKILL.md paths you actually read.
Create an ItemDefinition ScriptableObject with itemId, displayName,
and maxStack, using CreateAssetMenu. Use one example asset with
itemId "potion", displayName "Potion", and maxStack 10. Treat the asset
as read-only configuration during play.
Create two distinct runtime slot instances referencing that same asset.
Start their quantities at 2 and 5. Add one small probe component that
decrements only the first slot, then reports quantities 1 and 5,
confirms both slots reference the same asset, and checks that the
definition fields are unchanged. Start each probe run with fresh slots.
Keep the output to the data model and probe component. Give exact
asset-creation, component-attachment, Inspector-assignment, and Play-mode
steps. Distinguish checks you executed from checks I must perform.Создайте пример ассета через добавленный пункт меню Assets, прикрепите проверочный компонент к пустому GameObject, назначьте ассет в Inspector и перейдите в режим Play. В результате отдельные количества должны измениться с 2 и 5 на 1 и 5, а оба слота — сохранить ссылку на одно и то же описание предмета. После выхода из Play в ассете должны остаться значения potion, Potion и 10.
В документации Unity по ScriptableObject объясняется, как несколько объектов могут ссылаться на один общий ассет. Сам по себе такой ассет не является неизменяемым: по условиям примера код должен хранить меняющиеся количества в отдельных слотах, не изменяя общий ассет. Если меняются оба количества, проверьте, не ссылаются ли обе переменные на один объект слота: общим должно быть только описание предмета.
Что делать, если router или нужный навык не найден?
Проверяйте установку, обнаружение навыков клиентом и поиск файлов по отдельности. Следующее действие выбирайте по симптому:
| Симптом | Что проверить и сделать |
|---|---|
| Просмотр каталога завершается ошибкой до вывода списка | Прочитайте текст ошибки; проверьте активную версию Node.js, наличие Git и доступ к npm/GitHub. Исправьте соответствующую проблему и повторите запуск с --list. |
В списке установленных навыков есть инструкции для движка, но нет router | Повторите установку, включив router. При ручном копировании только содержимого skills/ отдельный каталог router/ остаётся за пределами установки. |
| Файлы есть, но агент не предлагает навыки | Убедитесь, что сеанс открыт в нужном проекте, а внутри каждой папки есть SKILL.md. Сверьте пути с документацией клиента; если список не обновился, перезапустите сеанс. |
Агент не может открыть путь, начинающийся с skills/godot/ или skills/unity/ | Найдите навык по имени в фактическом каталоге установки и убедитесь, что агент успешно прочитал файл, прежде чем он начнёт менять код. |
| Агент выбрал не тот движок | Откройте нужный подкаталог игры либо явно укажите движок и проект. Проверьте, по каким файлам агент определил движок и какую версию назвал. |
Особого внимания заслуживают пути: router описывает исходные файлы как skills/<category>/<name>/SKILL.md, а установщик CLI размещает отдельные каталоги навыков под их именами. Если агент буквально следует пути из исходного репозитория, он может не найти установленный навык. Такое расхождение структур стоит проверить, но оно не означает, что ошибка возникает в каждом клиенте.
Например, после установки для Codex или Cursor навык Godot может находиться по адресу .agents/skills/godot-2d-movement/SKILL.md, а его справочные материалы — рядом с ним. Используйте обнаруженный путь, вместо того чтобы создавать внутри игры ещё одну копию структуры исходного репозитория.
Проверяйте сторонние навыки перед использованием
Относитесь к этим файлам как к инструкциям, способным повлиять на правки агента и выполнение команд. Перед первым использованием прочитайте router, выбранные навыки, необходимые справочные материалы, а также скрипты и внешние команды, которые они предлагают запускать. Сверьте установку зависимостей, адреса скачивания, отправку данных и потенциально разрушительные операции с задачей, которую вы действительно поставили.
При --list набор навыков не устанавливается, но npx всё равно запускает установщик. Оставьте включённым обычное подтверждение выполнения команд и проверьте в сводке установки, какие существующие навыки могут быть перезаписаны.
При обновлении проверяйте также заголовок файла в формате YAML — frontmatter. Например, документация Claude Code по allowed-tools объясняет, что это поле может заранее разрешать использование инструментов; само по себе оно не изолирует навык в песочнице. Проверяйте изменения инструкций и вложенных команд, даже если метаданных совсем немного.
Начните с небольшого изменения, которое легко проверить по diff. После обновления навыка повторите соответствующую проверку в движке, прежде чем полагаться на него в более крупной задаче.
