voxel-icon

Invoke the skill with a request like turning a specific emoji into a native-palette voxel icon. The skill extracts the emoji's complete recognizable color signature, builds the subject from large rectilinear blocks on a coarse base-module grid, and outputs an opaque RGB PNG on an exact #F4F4F4 background.

Explicitly request a loop, animation, or GIF when invoking the skill. It first generates and approves a still, then creates forward and back pose keyframes, and assembles a four-frame rest-forward-rest-back sequence into a lossless animated WebP plus a GIF fallback using the build-generated-loop.py script.

Native mode is the default and preserves the source object's complete recognizable component colors with no fixed hue whitelist. Directed mode is opt-in and maps one complete preset from the bundled 40-preset Oreo registry onto the subject's structural roles, changing color only while preserving approved geometry.

No. The skill is designed for isolated objects built from a small number of large blocks, not dense cube grids, Minecraft environments, smooth low-poly renders, or 2D pixel art. Its quality gate explicitly rejects terrain, scenery, tiled cube surfaces, and flat 2D output.

The normalize-gray-background.py script refuses inputs whose outer border is not flat, contains outliers, or whose subject touches the canvas edge. Correct the render's background uniformity or framing rather than increasing tolerance, which could erase subject content.

The scripts require NumPy (version 1.24 or higher, below 3) and Pillow (version 10 or higher, below 13), as declared in scripts/requirements.txt. Install them with pip before running the background normalizer or loop assembler.