Summary

This project provides an AI-powered Claude skill for automating Spine 2D skeletal animation. It addresses the tedious aspects of character rigging, animation generation, and asset restyling, benefiting game developers and animators by streamlining production workflows and enabling rapid visual iteration.

How It Works

The system employs AI and computer vision techniques to automate Spine 2D animation tasks. Core functionality includes auto-positioning character parts from reference images using SIFT + RANSAC, building hierarchical skeleton JSON, and generating animations based on established principles. A novel feature, Reskin Studio, utilizes Google Gemini to restyle rigged characters via text prompts, automatically updating textures and applying them to the existing rig without re-rigging, significantly accelerating visual development.

Quick Start & Requirements

The recommended quick start involves pasting the SKILL.md content into a Claude Project, requiring no extra software. Alternatively, it can be integrated as a Claude Custom Skill via git clone. A manual pipeline involves running Python scripts (scripts/position_parts.py, scripts/build_spine_json.py, etc.). Prerequisites include Python 3.9+, opencv-python, Pillow, numpy, and a GEMINI_API_KEY for asset splitting. Official documentation and demos are linked within the README.

Highlighted Details

• AI-driven auto-rigging and animation presets (idle, walk, run, etc.).
• Reskin Studio: Text-prompt-based character restyling with automatic texture generation and rig application.
• Robust part auto-positioning via SIFT + RANSAC and occlusion analysis for draw order.
• Generates self-contained HTML5 previews using the Spine Web Player.

Maintenance & Community

The project is a product of Genielabs' AI animation research. The SKILL.md file, crucial for Claude integration, is automatically generated via GitHub Actions, indicating active development and a CI/CD process. Collaboration and licensing inquiries are directed to genielabs.tech.

Licensing & Compatibility

The project is released under the PolyForm Noncommercial 1.0.0 license, permitting free use for non-commercial purposes. Commercial use necessitates obtaining a separate license directly from Genielabs.

Limitations & Caveats

The primary limitation is the non-commercial use restriction imposed by the license. The recommended workflow heavily relies on the Claude AI platform. The asset splitting functionality requires an external API key for Google Gemini.