sprite-stacking — открытый скилл для ИИ-агентов от Дэниела Уайта (Daniel White). Он превращает четыре вида объекта в пиксель-арте (сверху, сбоку, спереди и сзади) в «sprite stack»: ленту плоских слоёв, которые игра рисует друг поверх друга, изображая 3D-объект, который можно вращать. Работает с Claude Code, Codex, Cursor, OpenCode, Gemini CLI и Pi. Репозиторий создан 20 ноября 2026 года, на момент нашей проверки 21 ноября 2026 года у него было 187 звёзд. Лицензия — MIT.

В этом гайде — что такое sprite stacking, что добавляет скилл, как его установить, что ему нужно на входе и где у него ограничения. Все команды ниже скопированы из README репозитория или из его SKILL.md. Файлы мы прочитали 21 ноября 2026 года, но сам скилл не запускали, так что описанные результаты — это то, что должно получиться по документации.

Что такое sprite stacking

Sprite stack — это объект, видимый сверху и нарезанный на горизонтальные слои, как буханка, которую режут от пола вверх. Игра рисует слои снизу вверх. Каждый поворачивается на один и тот же угол, сплющивается по вертикали под наклон камеры и поднимается на 1 пиксель над предыдущим. Получается что-то вроде маленькой воксельной модели, которая плавно вращается, но по сути это обычная 2D-отрисовка: никакого 3D-движка, никаких мешей, и под любым углом пиксели остаются чёткими.

В README прямо сказано, что техника не новая: «Sprite stacking is a long-standing indie game technique, not invented here.» Скилл добавляет к ней вырезание по четырём видам и рабочий процесс для агента.

Обычно больнее всего рисовать сами слои. Машина из 30 слоёв — это 30 маленьких картинок, которые должны точно совпадать. Скилл это обходит: вы (или ваш агент) рисуете четыре обычных вида, а скрипт вырезает из них слои.

Что делает скилл

README описывает четыре шага:

  1. Виды: лист с видами сверху, сбоку, спереди и сзади, в ортографической проекции, в один ряд.
  2. Вырезание: воксель остаётся только там, где его покрывают все четыре вида.
  3. Слои: вырезанный объём режется на ленту плоских слоёв, начиная с нижнего.
  4. Рендер: каждый слой поворачивается, сплющивается под наклон и поднимается на 1 px.

В папке скилла лежат:

  • SKILL.md — инструкции, которые читает агент: как получить хороший лист из четырёх видов, чек-лист перед нарезкой, флаги слайсера, цикл отрисовки и его параметры, чек-лист «готово, когда» и таблица прошлых ошибок с исправлениями.
  • scripts/views_to_slices.py — слайсер. Он убирает фон, снимает 1-пиксельные контуры вокруг видов, приводит всё к одной общей палитре, вырезает слои и может сохранить проверочное изображение и отдельную страницу-просмотрщик.
  • scripts/viewer.html — просмотрщик в браузере, который открывается и сам по себе и принимает перетащенные ленты слоёв.
  • references/engines.md — короткие рецепты для Canvas и React в вебе, Godot 4, Unity, а также Phaser, Pygame и всего остального.

Установка в Claude Code или Codex

Установка в одну строку из README использует skills CLI, которому нужен Node 22.20 или новее:

npx skills add danielwh2/sprite-stacking

Так скилл ставится в текущий проект. Согласно README, добавьте -g, чтобы установить его для всех проектов, и -a claude-code (или codex, cursor и т. д.), чтобы выбрать агента.

Другой вариант — скопировать папку skills/sprite-stacking из репозитория в папку скиллов вашего агента:

Агент Папка
Claude Code ~/.claude/skills/
Codex, Cursor, OpenCode, Gemini CLI, Pi ~/.agents/skills/

Слайсер написан на Python, поэтому понадобится ещё Python 3 с Pillow и NumPy. Команда из README:

pip install pillow numpy

Как пользоваться: что просить у агента

Вызывать скилл по имени не нужно. После установки просто попросите то, что хотите, и агент сам его подхватит. Примеры из README:

  • «Сделай вращаемую машину в пиксель-арте.»
  • «Сделай sprite stack из этого листа с 4 видами и дай мне вращение на поворотном столе.»
  • «Добавь в мою игру на Godot псевдо-3D дерево в пиксель-арте.»

SKILL.md велит агенту выбрать путь в зависимости от того, что вы ему дали:

  • PNG-лента слоёв или экспорт слоёв из MagicaVoxel: сразу к отрисовке.
  • Лист из четырёх видов: сначала проверка листа, потом вырезание.
  • Только промпт или идея: сначала он делает лист из четырёх видов, затем вырезает и рендерит.

Если листа нет, агент воспользуется инструментом генерации изображений, если он у него есть, с промптом, прописанным в SKILL.md. Если нет — нарисует четыре вида сам, как пиксель-арт, в коротком скрипте на Python. README говорит об этом просто: «No image generator? The agent draws the views itself in a short Python script.»

В уже существующей игре SKILL.md велит агенту сначала прочитать ваш рендерер (движок, масштаб пикселей, как рисуются и сортируются спрайты) и вписать стек в него, никогда не добавляя второй canvas или второй конвейер отрисовки.

Что нужно на входе

У листа из четырёх видов строгие правила, и большинство плохих результатов — от их нарушения. Из SKILL.md:

  • Один ряд в порядке TOP, SIDE, FRONT, BACK на ровном белом фоне, с чёткими промежутками между видами.
  • TOP смотрит строго вниз, перед объекта направлен вниз. На SIDE перед направлен влево.
  • Строго ортографическая проекция: без перспективы, без наклона, без вида 3/4.
  • Одинаковый масштаб во всех четырёх видах: длина TOP равна длине SIDE, ширина TOP равна ширине FRONT и BACK, высота SIDE равна высоте FRONT и BACK.
  • Плоские заливки и чёткие контуры. Мягкие «аэрографные» края и тонкие 1-пиксельные внутренние линии размазываются, когда слои поворачиваются, и скилл советует перерисовать, а не спасать.

Там же три уровня размера:

  • Chunky retro: 15–20 слоёв, примерно 25×48 px, показ в масштабе 8–10×.
  • Detailed hi-bit: 26–44 слоя, от 36×72 до 46×107 px — хватает на решётки, логотипы и диски со спицами.
  • Showcase / видео 1080p: 36–56 слоёв, от 30×30 до 148×148 px, показ в масштабе 4–6×.

Запуск слайсера вручную

Обычно слайсер запускает агент, но можно сделать это и самому из корня репозитория командой из README:

python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
  --slices 36 --preview check.png --html viewer.html

views.png — ваш лист из четырёх видов, slices.png — лента слоёв, которую он запишет. Флаги, перечисленные в README:

  • --slices N: число слоёв. 15–20 для крупного стиля, 32–48 для детального.
  • --order reading: принудительный порядок TOP, SIDE, FRONT, BACK. По умолчанию скрипт сопоставляет виды по пропорциям.
  • --round: башни, воздушные шары и горшки вырезаются круглыми, а не квадратными.
  • --side-nose right: если вид SIDE смотрит вправо.
  • --colours N: размер общей палитры; 0 сохраняет все цвета.
  • --normals path.png: дополнительно сохранить подходящую ленту слоёв с картой нормалей.
  • --emissive path.png: дополнительно сохранить автоматически найденную маску свечения (фары, окна, неон).

В SKILL.md есть ещё несколько, в том числе --top-nose (передайте down для всего, что не транспорт), --shade, --bg-tol и --dark-thresh.

check.png показывает четыре извлечённых вида, четыре угла поворота и разнесённый вид. Скилл велит агенту посмотреть на него до того, как писать хоть какой-то игровой код.

Просмотрщик

--html записывает отдельную страницу. Согласно README, в ней есть поворотный стол, режим Scene с процедурными объектами, скан слоёв, разнесённый вид и режим Play, где можно ездить на WASD или стрелках. Ещё там время суток, перетаскиваемое солнце с тенями, дождь и снег, а также кнопка экспорта, которая запекает PNG-лист спрайтов в 16 направлениях. Последнее удобно, если вашему движку нужны просто обычные направленные спрайты.

Как встроить в игру

Цикл отрисовки везде одинаковый: для каждого слоя от земли вверх поверните его вокруг центра, отмасштабируйте y на коэффициент сплющивания, поднимите на индекс, умноженный на шаг, привяжите к целым пикселям и рисуйте с фильтрацией по ближайшему соседу. SKILL.md даёт значения по умолчанию: шаг 1.0 и сплющивание 0.75 для наклонной камеры сверху (1.0 — взгляд строго вниз). В references/engines.md есть готовая функция для Canvas 2D и скрипт Node2D для Godot 4, а также заметки для Unity (один SpriteRenderer на слой, фильтр Point) и для Phaser или Pygame.

Два совета из скилла важны для производительности и картинки. Сортируйте стеки целиком по точке касания земли и никогда не перемешивайте слои двух объектов. А статичные стеки запекайте в обычные спрайты при загрузке игры: скилл отмечает, что 200 деревьев по 30 слоёв — это 6000 вызовов отрисовки за кадр.

Ограничения

Они взяты из чек-листа скилла и его таблицы прошлых ошибок:

  • Скрытые полости заполняются. Вырезание оставляет только то, что покрывают все четыре силуэта, поэтому кузов пикапа или полая арка, которых не видно ни на одном виде, выходят сплошными. Нависающие части, сквозь которые на виде сбоку виден просвет, например поднятое заднее антикрыло, сохраняются. Полости придётся поправить вручную после вырезания.
  • Круглые детали выходят квадратными, если на виде сверху нет пиксельного круга или если не передать --round, когда круглая часть уже основания.
  • Детали шириной 1 px мерцают при вращении стека. Столбы, верёвки и антенны должны быть не тоньше 2 px; слайсер выводит предупреждение.
  • Выступы превращаются в полки. Что-то торчащее из стены, например ящик для цветов или вывеска, вырезает полку вдоль всей стены. Мелкие выступы рисуйте плоскими.
  • Замкнутые просветы выходят сплошными. Фон, полностью окружённый объектом внутри вида (между ногами, плавниками или верёвками), считается частью объекта. Каждый просвет должен выходить к краю своего вида.
  • Объекты не по центру качаются. Стек вращается вокруг середины своего ограничивающего прямоугольника, поэтому центрируйте объект в видах.
  • Только пиксель-арт. Техника и слайсер сделаны для маленьких спрайтов с плоской заливкой. Настоящую 3D-модель для игры на three.js или Unity 3D так не получить.

Лицензия

Репозиторий распространяется по лицензии MIT (copyright 2026 Daniel White) — это видно на GitHub и в файле LICENSE. Его можно использовать, изменять и включать в коммерческие проекты при условии, что вместе с копиями кода сохраняется уведомление об авторских правах и лицензии. О лицензии спрайтов, сделанных с его помощью, в README ничего не сказано.

Частые вопросы

Что такое sprite stacking?

Способ изобразить 3D в 2D-игре. Объект хранится как лента плоских слоёв, видимых сверху, а игра рисует их снизу вверх, каждый повёрнутым на один угол и поднятым на 1 пиксель. Выглядит как маленькая вращающаяся воксельная модель, но остаётся чётким пиксель-артом.

Скилл sprite-stacking бесплатный?

Да. Это open source по лицензии MIT. Нужен только Python 3 с Pillow и NumPy, а также Node 22.20 или новее, если ставить через npx skills. Подписка или оплата API вашего ИИ-агента — отдельно.

Работает ли он с Claude Code и Codex?

Да. Оба указаны в README. Установите командой npx skills add danielwh2/sprite-stacking (с -a claude-code или -a codex, чтобы выбрать агента) или скопируйте skills/sprite-stacking в ~/.claude/skills/ для Claude Code или в ~/.agents/skills/ для Codex.

Нужен ли генератор изображений?

Нет. Если он есть у агента, скилл даёт ему промпт для листа из четырёх видов. Если нет, агент сам нарисует виды в коротком скрипте на Python. Можно также дать ему собственноручно нарисованный лист, ленту слоёв или экспорт слоёв из MagicaVoxel.

Можно ли использовать результат в Godot, Unity или Phaser?

Да. В references/engines.md есть скрипт для Godot 4, заметки для Unity, функция Canvas 2D для веба и React и общий цикл для Phaser и Pygame. Просмотрщик также умеет экспортировать PNG-лист спрайтов в 16 направлениях для движков, которым нужны обычные спрайты.

Почему части моего спрайта выходят сплошными или квадратными?

Слайсер оставляет воксель только там, где его покрывают все четыре вида. Полости, скрытые от всех видов, заполняются, круглым деталям нужен круг на виде сверху или флаг --round, а просветы, полностью замкнутые внутри вида, выходят сплошными. Как это исправить — в разделе «Ограничения» выше.

Похожие гайды

Источники

Проверено 21 ноября 2026 года: README danielwh2/sprite-stacking, SKILL.md, references/engines.md, LICENSE и данные репозитория на GitHub (создан 20 ноября 2026 года; 187 звёзд на 21 ноября 2026 года).

Сделали игру с машинами или объектами в технике sprite stacking? Отправьте её на VibeGamer.