ClaudeMap

spine-hero

Agent skill that animates a 2D game hero from one painting: parts cut onto a Spine skeleton, every move written as code, a script gate plus an independent defect check, and a human with final say

Skills & Commandsskillanimationspinegame developmentmulti-model

spine-hero is an agent skill for Claude Code, Codex and Cursor that turns a single painting into a rigged, animatable hero. The painting is cut into parts on a Spine skeleton; every move is written as keys and IK on that rig — never as frames — so swapping gear still plays every move. An orchestrator writes one brief per move and runs moves in parallel; an image-to-video model animates the hero's own painting as a timing reference only (never traced, never used as frames); an image model paints what the painting never showed (hidden parts, swappable gear, key poses for fast blows); a strong coding model authors each move, captures it, and looks at its own result. Quality is enforced by a script gate that measures captures (sliding feet, ground speed, cracks, moves that do not end at rest, drawings outside the hero's box) — no model judges the numbers — and by a second, independent model that checks 2x close-ups against a list of every defect a human ever caught. The human decides finally, and each flaw they catch becomes a new line in the defect list or a new gate check. Roles are documented as tiers (orchestrator, author, gate, review, check, video, image, human), with model names given as examples, not requirements.

What it does

  • One painting in, rigged hero out: parts cut onto a Spine skeleton, moves authored as keys and IK code — never frames
  • Script gate measures every capture: sliding feet, ground speed, cracks, return-to-rest, out-of-box drawings; no model judges the numbers
  • Independent model reviews 2x close-ups of feet and head against a living defect list (13 past defects in the walkthrough)
  • Reference video gives timing and beats only; image models paint hidden parts, swappable gear and key poses
  • Roles as tiers — orchestrator, author, gate, review, check, video, image, human — with model names as examples, not requirements

When to use it

Use when a game hero needs a real animation set from one artwork — walk, attacks, taunts — and you want gear swaps to keep working, with mechanical gates catching the flaws models miss (sliding feet, cracks) and your own eye feeding the defect list for the next run.

Getting started

The skill ships at skills/spine-hero/ in the repository (SKILL.md plus reference docs: pipeline, rig, locomotion, moves, reference-video, orchestration, defects, gate). Try the gate on the bundled example first:

node --test skills/spine-hero/scripts/gate.test.mjs
cp skills/spine-hero/assets/metrics.example.json /tmp/metrics.json
node skills/spine-hero/scripts/gate.mjs /tmp/metrics.json       # PASS example-hero walk: 8/8 checks

Install (Claude Code plugin):

/plugin marketplace add enoch3712/spine-hero-skill
/plugin install spine-hero@spine-hero-skill

Then ask your agent to use the skill and plan a move, feeding it a reference video via the template in reference-video.md.

Things to know

The README's own limits: it was built on one game (side-view painted heroes, a web runtime, Spine 4.2) and has not been tried with other engines or art styles. The rig builder and the capture are yours to write — most of the setup work; the shipped scripts are the gate (with tests) and a small lock helper. The gate's pixel limits were calibrated at one capture size, and gate.md says which limits carry over. Plugin install routes for Codex and Cursor are untested. Using it costs model tokens, and the video and image models may cost money. 41 stars as of writing (2026-11-14).

Repository

enoch3712/spine-hero-skill

Charted

Related on the map

  • An instruction-only skill that makes agents research before they ask, plan before they build, and verify before they call anything done.

    • workflow
    • verification
    • quality
    • skill
  • Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
  • An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap