Agent Sprite Forge

Установка

git clone https://github.com/0x0funky/agent-sprite-forge.git
cd ./agent-sprite-forge
python3 -m pip install -r ./requirements.txt
mkdir -p ~/.codex/skills
cp -R ./skills/* ~/.codex/skills/

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Набор из трех скиллов. generate2dsprite сам планирует ассет по описанию, рисует сырой лист встроенной генерацией изображений на пурпурном фоне, а локальный Python-скрипт убирает фон, режет кадры, выравнивает их и собирает прозрачные PNG и GIF. generate2dmap делает карты: базовый слой, набор отдельных объектов, коллизии, зоны и редактируемые сцены Godot с TileMap. video2dsprite получает более плавную анимацию из короткого видео, но генерация видео работает только в Grok Build.

Для кого. Для инди-разработчиков игр и прототипировщиков, которым нужны 2D-ассеты без художника.

Пример запроса к агенту

Сгенерируй пиксельного рыцаря с анимацией ходьбы и атаки, вид сверху, экспортируй кадры и GIF

Ограничения

Нужен агент со встроенной генерацией изображений: README ориентирован на Codex и Grok Build. Для постобработки требуются Python, Pillow и numpy, для видео еще ffmpeg. Полный конвейер video2dsprite работает только в Grok Build. Генерация изображений в Codex требует доступа к OpenAI, из России без VPN не работает.

Как отключить. Удалите папки generate2dsprite, generate2dmap и video2dsprite из ~/.codex/skills/.

Проверка безопасности

• Запускает локальные Python-скрипты обработки изображений
• Использует платную генерацию изображений агента

Коротко о README

README показывает примеры прототипов на Unity, Godot и JavaScript, собранных с помощью скиллов, и объясняет разделение работы: агент планирует, генерация рисует, скрипты чистят и экспортируют. Описаны три скилла и их ограничения, установка в Windows, macOS и Linux с копированием в каталоги Codex и Grok, требования к Python. Лицензия MIT.

SKILL.md

---
name: generate2dsprite
description: "Generate and postprocess general 2D game assets and animation sheets: pixel-art sprites, clean HD map props, creatures, characters, NPCs, spells, projectiles, impacts, props, summons, and transparent GIF exports. Use when Codex should infer the asset plan from a natural-language request, match a reference or map art style, call built-in `image_gen` for solid-magenta raw sheets, and use the local processor only for chroma-key cleanup, frame extraction, alignment, QC, and transparent exports."
---

# Generate2dsprite

Use this skill for self-contained 2D sprite or animation assets.

When a larger game or playable prototype needs sprites, use this skill for the visible sprite assets and keep runtime/game assembly separate. Do not replace requested sprite assets with code-drawn placeholders.

## Parameters

Infer these from the user request:

- `asset_type`: `player` | `npc` | `creature` | `character` | `spell` | `projectile` | `impact` | `prop` | `summon` | `fx`
- `action`: `single` | `idle` | `cast` | `attack` | `shoot` | `jump` | `hurt` | `combat` | `walk` | `run` | `hover` | `charge` | `projectile` | `impact` | `explode` | `death`
- `view`: `topdown` | `side` | `3/4`
- `sheet`: `auto` | `2x2` | `2x3` | `2x4` | `3x3` | `3x4` | `4x4` | `5x5` | `custom_grid` | `strip_1x3` | `strip_1x4`
- `frames`: `auto` or explicit count
- `bundle`: `single_asset` | `unit_bundle` | `spell_bundle` | `combat_bundle` | `line_bundle` | `hero_action_bundle` | `engine_atlas`
- `effect_policy`: `all` | `largest`
- `anchor`: `center` | `bottom` | `feet`
- `scale_strategy`: `fit` | `preserve`
- `scale_profile`: `none` | `create_from_accepted_action` | `reuse_existing`
- `margin`: `tight` | `normal` | `safe`
- `art_style`: pixel_art | clean_hd | pixel_inspired | retro_pixel | map_style | project-native
- `reference`: `none` | `attached_image` | `generated_image` | `local_file`
- `layout_guide`: `none` | `geometry` | `character_anchor`

Похожие