Spine Animation AI — скилл
Скилл Claude для 2D-анимации в Spine: расставляет части персонажа, строит скелет и собирает HTML-превью
- 609 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент записывает на диск и запускает четыре Python-скрипта
- SKILL.md ставит зависимости через `pip` с ключом `--break-system-packages`, который обходит защиту системного Python
- `split_character.py` отправляет картинку персонажа во внешний сервис Gemini
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/spine-animation-aiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент записывает на диск и запускает четыре Python-скрипта
- SKILL.md ставит зависимости через `pip` с ключом `--break-system-packages`, который обходит защиту системного Python
- `split_character.py` отправляет картинку персонажа во внешний сервис Gemini
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл ведет агента от готовых картинок персонажа к анимации в Spine 4.2: из PNG отдельных частей тела получаются `skeleton.json`, текстурный атлас и интерактивный `preview.html`. Работу делают четыре скрипта на Python, которые `SKILL.md` содержит прямо в тексте, поэтому клонировать репозиторий агенту не нужно. Скрипт `position_parts.py` находит положение каждой части на собранной картинке-образце методом SIFT и RANSAC, а порядок отрисовки определяет по перекрытиям. Скрипт `build_spine_json.py` строит иерархию костей и слоты, `make_atlas.py` упаковывает атлас, `generate_spine_player.py` собирает HTML-страницу с официальным Spine Web Player. Анимации вроде покоя, ходьбы и прыжка агент строит по 12 принципам анимации. Готовые скелеты он тоже правит: смещения записываются в JSON, и каждую поправку можно просмотреть и откатить. Если есть только цельная картинка героя, `split_character.py` через Gemini разбирает ее на части и режет на прозрачные PNG. В репозитории лежит рабочий пример с персонажем в сомбреро (10 частей, 16 костей, двухсекундный цикл покоя) и отдельное приложение Reskin Studio, которое перерисовывает скин персонажа по описанию в одну фразу.
Для кого. Для 2D-аниматоров и разработчиков игр, у которых есть нарезанные части персонажа и нужно быстро получить скелет и черновые анимации для Spine.
Подходит, если
- У вас PNG отдельных частей персонажа и нужны скелет с анимациями покоя или ходьбы
- Есть цельная картинка героя, которую нужно разобрать на части скриптом `split_character.py`
- Нужно быстро показать анимацию в браузере без сервера: превью собирается в один HTML-файл
- Готовый скелет съехал, и надо поправить смещения костей и порядок слоев
- Расположение частей хочется подвинуть вручную в интерактивном редакторе `sombrero_editor.html` и выгрузить JSON
Не подходит, если
- Проект коммерческий: лицензия PolyForm Noncommercial 1.0 не допускает коммерческого использования без отдельной договоренности
- Нужна трехмерная анимация: скилл делает только двухмерную скелетную анимацию для Spine
- Нужен новый персонаж с нуля: скилл анимирует готовые ассеты и сам героев не рисует
- Вы работаете в другом формате анимации: результатом служат файлы Spine с расширениями .json, .atlas и .png
Пример запроса к агенту
У меня PNG отдельных частей персонажа. Собери скелет, сделай анимации покоя и ходьбы и покажи превью.Ограничения
Лицензия PolyForm Noncommercial 1.0 разрешает только некоммерческое использование, для коммерческого авторы предлагают связаться через genielabs.tech.
Скриптам нужны Python и библиотеки OpenCV, Pillow и NumPy, а для разбора картинки еще google-generativeai. SKILL.md ставит их командой pip install с ключом `--break-system-packages`. Скрипту `split_character.py` нужен ключ `GEMINI_API_KEY`. Инструкции по установке рассчитаны на проекты Claude и среды с каталогом `/mnt/skills/`, для других агентов их нет.
Метод SIFT с RANSAC опирается на ключевые точки картинки, поэтому стилизованную графику с малым числом деталей, возможно, придется поправить вручную.
Как отключить. Удалите текст скилла из знаний проекта Claude либо папку `/mnt/skills/user/spine-animation`. Скрипты агент сохраняет в `/home/claude/spine-scripts/`, их можно удалить вместе с временными файлами.
Частые вопросы
Как подключить скилл к Claude?
Первый способ: создайте проект на claude.ai, добавьте в знания проекта полный текст `SKILL.md` и загрузите ассеты. Второй способ для сред с каталогом `/mnt/skills/`: `git clone https://github.com/GenielabsOpenSource/spine-animation-ai.git /mnt/skills/user/spine-animation`.
Можно ли запустить скрипты без Claude?
Да. Скрипты — обычные файлы Python: их запускают вручную по порядку, а зависимости ставит команда pip install из способов установки.
Как скилл расставляет части персонажа?
Скрипт ищет ключевые точки SIFT в каждой части и на собранном образце, сопоставляет их и оценивает сдвиг, масштаб и поворот методом RANSAC. Результат принимается от четырех совпадений, иначе включается запасной вариант.
Для какой версии Spine подходят файлы?
Скилл выдает `skeleton.json`, атлас и PNG в формате Spine 4.2. Справка по формату лежит в репозитории, в файле `references/spine-json-spec.md`.
Что такое Reskin Studio?
Это отдельное приложение в папке `reskin-app`. По описанию вроде «изумрудно-серебряные королевские одежды» оно перерисовывает персонажа через Gemini, режет результат на текстуры слотов и ставит на готовый скелет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл рисует интерактивные изометрические иллюстрации в SVG: шейдеры WebGL, страница HTML или компонент React, идея объясняется работающим устройством
Скилл пересобирает объект с референсного изображения в процедурную 3D-модель Three.js, написанную кодом, а не скачанную
Скилл ведет агента от сгенерированной картинки к игровому ассету: спрайты, анимация из видео и проверка перед выпуском
Двенадцать скиллов, по которым агент собирает однофайловые HTML-анимации: слайды, схемы протоколов, архитектурные диаграммы и демо для записи экрана
Скилл превращает ваше фото или описание в рисованного персонажа и делает им схемы, карточки знаний и слайды
Скилл Claude Code для коротких анимационных роликов, нарисованных кодом: семь стилей, согласование сюжета и раскадровки, озвучка и рендер в MP4
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Spine Animation AI (эта запись) | нет | 609 | |
| Agent Sprite Forge | нет | 4 633 | скиллы Codex для спрайтов, листов анимации и карт без скелетного ригга Spine |
| Sprite Gen | нет | 3 101 | спрайты и анимация по одной базовой картинке, без скелетного ригга |
Коротко о README
Рядом с кодом лежат демо-страницы: просмотр готовой анимации и интерактивный редактор частей, из которого выгружается JSON расположения. Формат поправок описан в `docs/adjustment-format.md`: для каждой части хранятся исходное смещение, правка и итог.
Бейдж для README
Исходный SKILL.md
---
name: spine-animation
description: >
Create Spine 2D skeletal animations from pre-existing character assets (separated body-part PNGs,
atlas spritesheet, or a full character image). Use this skill whenever the user wants to animate
a 2D character, create Spine JSON from existing art assets, rig a character with bones, build
walk/idle/run/attack animations, produce an interactive Spine Web Player preview, or generate
Spine-compatible export files (.json + .atlas + .png). Also trigger when the user mentions
"Spine animation", "2D rigging", "skeletal animation", "bone animation", "cutout animation",
"animate this character", "make this walk", "create walk cycle", or uploads separated character
body parts and wants them animated. This skill handles the full pipeline: asset analysis,
skeleton rigging, animation keyframing, Spine JSON export, and interactive HTML5 preview.
---
<!-- ⚠️ AUTO-GENERATED FILE — DO NOT EDIT DIRECTLY
Edit SKILL.template.md instead, then push to trigger rebuild.
Scripts are embedded automatically by build_skill.py via GitHub Actions. -->
# Spine Animation Skill
Turn pre-existing 2D character assets into fully animated, interactive Spine animations.
## Step 0: Set Up Scripts
This skill includes Python scripts that do the heavy lifting. Claude MUST write them to disk
before use. Each script is embedded below — Claude should save them to `/home/claude/spine-scripts/`
at the start of every session.
```bash
mkdir -p /home/claude/spine-scripts
pip install opencv-python Pillow numpy google-generativeai --break-system-packages -q
```
### Embedded Scripts
The following scripts are auto-injected from the repository's `scripts/` directory.
**Claude: read these carefully, then write each one to `/home/claude/spine-scripts/`**
before running the pipeline.