carve-sprite

Generates four-direction walking sprites from a three-view character sheet image.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/ababup1192/flix_ge_studio --skill carve-sprite-ababup1192
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: carve-sprite
Source: https://github.com/ababup1192/flix_ge_studio/tree/main/.agents/skills/carve-sprite
Command: npx skills add https://github.com/ababup1192/flix_ge_studio --skill carve-sprite-ababup1192

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating consistent four-direction walking animations for game characters normally requires hand-drawing every frame. This Skill converts a single three-view character illustration (front, right, back) into a complete sprite set with walking frames, without redrawing anything. ## Core Features & Use Cases - Visual Hull Carving: Reconstructs a 3D volume from the three views and swings arms and legs in 3D, so idle frames match the source art pixel-for-pixel and walk frames stay consistent across all four directions. - Body Proportion Profiles: Adjust cut positions via a JSON profile (headRatio, hipRatio, reach, tool) for chibi or short-legged characters. - Self-Inspection Output: Reports projection mismatch, mirror symmetry, ground contact, and fragmentation metrics so you can verify quality before use. - Use Case: You generated a character with an AI image tool and need it walking in four directions in your game. Run the carve script on the three-view sheet to produce sprite.json plus per-direction PNGs and a walk.gif in the gallery folder. ## Quick Start Run the carve script on my three-view character sheet to generate a 32x48 four-direction walking sprite with sprite.json and gallery output.

Frequently Asked Questions about carve-sprite

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create four-direction walking sprites from one character image?

Arrange front, right, and back views of the character side by side in one image, then run the carve.py script with an id and target size. It outputs a sprite.json plus per-direction PNGs and a walk.gif, with idle, walk_l, and walk_r frames.

What image format does the sprite carving tool require as input?

The input must be a single image with front, right, and back views arranged left to right, on a flat single-color or checkerboard background. The character must be an upright humanoid holding at most one item, and scaled-up art is acceptable.

How do I fix wrong body proportions in generated walk sprites?

Pass a JSON profile with headRatio (neck height) and hipRatio (where arms end and legs begin) as fractions of total height. You can also set reach for swing amplitude and tool: none to stop false item detection on skirt hems.

Can AI-generated character art be turned into game sprites?

Yes, if the AI output shows the character in front, right, and back views on a clean background. The tool carves a 3D volume from those views and animates limbs, producing sprite.json and gallery images usable in the game engine.

What are the limitations of visual hull sprite generation?

Shapes visible only in the back view, like hair on the nape, are not reproduced since the back is mostly a mirror of the front. Colors under rotating arms are inferred from visible regions, and non-walking motions like attacks are not supported.