What is the spine-animation-ai skill?
Spine-animation-ai is a skill that turns separate 2D body-part images into a rigged Spine character. It positions parts with computer-vision matching, writes the skeleton JSON with bone hierarchy, generates animations such as idle, walk, run, attack, wave and jump, then renders an HTML5 preview with the Spine Web Player.
Spine-animation-ai is a skill built for 2D skeletal animation. Given separate body-part images, it positions them with SIFT and RANSAC matching, then writes a skeleton JSON with a proper bone hierarchy ready for Spine.
A bundled example rigs a sombrero character with 10 body parts and 16 bones, plus an idle animation with hip breathing and torso sway, so you can see the expected output before running it on your own art.
What changes in the agent's output
- The agent positions each body-part image automatically instead of asking you to place bones by hand.
- It writes skeleton JSON with bone hierarchy, matching the structure Spine expects for rigging.
- It generates a set of stock animations, including idle, walk, run, attack, wave and jump.
- It builds an interactive HTML5 preview with the Spine Web Player so you can check the rig in a browser.
- Reskin Studio repaints the character from a text description while keeping the existing rig intact.
Who the skill is for
Best for
- Game and animation teams who have cut-out body-part art and want a working Spine rig fast.
- Anyone previewing a character's idle, walk or attack cycle before hand-tuning it in Spine proper.
- Projects that need quick recolors of an already-rigged character for alternate skins.
Not for
- When you already have motion in the interface and want it audited rather than rigged from scratch, Improve Animations reviews that motion and plans fixes.
- If your animation output needs to be animated SVG for a web page rather than a game skeleton, nakkas MCP Server renders that instead.
- Turning a Figma design or screenshot into matching interface code is a separate job that Build Design handles for standard UI work.
Use it with UiChemy
The skill rigs and animates a character for a game or interactive page, outside WordPress entirely. Once that build needs a page around it, UiChemy AI to WordPress imports the finished build as an editable page. Click Get Started on uichemy.com.
How to install Spine Animation AI Skill for 2D Skeletal Rigging
git clone https://github.com/GenielabsOpenSource/spine-animation-aiGet the skill contents
Clone the repository, or copy the contents of SKILL.md directly into a Claude Projects knowledge entry since the skill keeps its scripts embedded.
Place it where your agent loads skills
For an environment that mounts skills, copy spine-animation to /mnt/skills/user/spine-animation, the path the README names.
Install the Python dependencies
Run pip install opencv-python pillow numpy with Python 3.9 or later active, matching the versions listed in the repository.
Ask the agent to use it
Reference the skill by name with a character image, for example: use the spine-animation skill to rig and animate this character.
Check that it loaded
Give the agent a set of body-part images and confirm it returns skeleton JSON with bone hierarchy, an idle animation, and a working HTML5 preview link.
Key features
- Automatic part positioningSIFT and RANSAC matching lines up each body-part image against the others instead of requiring manual placement.
- Skeleton JSON generationWrites bone hierarchy and skeleton data in the structure the Spine runtime and editor expect.
- Stock animation setGenerates idle, walk, run, attack, wave and jump animations for the rigged character without extra keyframing.
- Interactive HTML5 previewBuilds a browser preview using the Spine Web Player so the rig and animations can be checked without opening Spine.
- AI-assisted skeleton refinementLets the agent adjust bone placement and hierarchy after the first pass instead of starting over.
- Reskin Studio recoloringRepaints a character from a natural-language description while keeping the existing rig and bone structure.
- Sombrero example rigShips a worked example with 10 body parts, 16 bones and an idle animation with hip breathing and torso sway.
- Script-based manual pipelineEach stage, part positioning, JSON building, texture packing and preview generation, can also be run as a standalone Python script.
Frequently asked questions
What is the spine-animation-ai skill?
It is a skill that automates 2D skeletal animation. It takes separate body-part images, positions them with computer-vision matching, writes a Spine skeleton JSON with bone hierarchy, generates stock animations such as idle and walk, and renders an HTML5 preview.
How do I install the spine-animation-ai skill?
Clone the GenielabsOpenSource/spine-animation-ai repository, or paste SKILL.md into a Claude Projects knowledge entry since it embeds its own scripts. For mounted-skill setups, copy spine-animation to /mnt/skills/user/spine-animation, then install the listed Python dependencies.
What does the spine-animation-ai skill need to run?
Python 3.9 or later plus opencv-python 4.8 or newer, Pillow 10.0 or newer and numpy 1.24 or newer. These handle the image matching and skeleton output the skill builds its animations from.
Can the spine-animation-ai skill recolor a character after rigging?
Yes. Its Reskin Studio component takes a natural-language description of the look you want and repaints the character while keeping the existing rig and bone structure, so an alternate skin does not need a new rig.
Does the spine-animation-ai skill work in Cursor or Codex?
The README documents Claude Projects and mounted Claude skill locations as the install paths, plus a manual pipeline of standalone Python scripts anyone can run outside an agent. It does not list a Cursor or Codex specific install.
What animations does the spine-animation-ai skill generate?
The included set covers idle, walk, run, attack, wave and jump. The bundled sombrero example shows an idle animation with hip breathing and torso sway as a reference for the output quality.
Can I use the spine-animation-ai skill commercially?
The repository ships under PolyForm Noncommercial 1.0.0, which permits free noncommercial use. Commercial use needs a separate license from Genielabs, the project's publisher, rather than the default terms in the repository.
What is Reskin Studio in the spine-animation-ai skill?
It is the recoloring component of the skill. You describe the aesthetic you want in plain language, and it repaints the rigged character's textures to match while leaving the bone hierarchy and animations untouched.