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.