Voxel Icon

The free tier of voxel-obj: a self-contained Codex Skill for generating clean, playful, low-density isometric voxel icons, plus 30 free icons from the pool.

What's in this repository

Part	Contents
skill/voxel-icon	The production art Skill: still voxel icons and explicitly requested four-frame physically credible loops. Native object colors by default; directed Oreo-derived palettes optional.
icons/	30 free static icons — 15 subjects × 2 palettes (native + directed), 1254 px PNG on the standard #F4F4F4 background. See MANIFEST.md.

The expanded pool and transparent icon versions ship as one-time paid packs; the Full pack also includes the Three.js source: https://voxel-icon.vercel.app/price.html

What the art Skill produces

• One isolated subject built from a small number of large rectilinear blocks.
• A fixed orthographic three-quarter camera and shared coarse base-module scale.
• Opaque polished face-lit acrylic with broad whole-face highlights, not edge shine.
• A suspended composition with weak or absent external shadow.
• An opaque RGB output with exact #F4F4F4 background.
• Optional four-frame rest → forward → rest → back physical-motion loops with fixed connections and real 3D pose changes.

Palette modes

Mode	Behavior
native	Default. Preserves the source object or emoji's complete recognizable component colors and functional black/white.
directed	Opt-in. Selects one complete relationship from the bundled 40-preset Oreo-derived registry.
directed-aggressive	Opt-in. Allocates colors across distinct real layers while keeping every continuous face flat.

Native mode has no fixed hue whitelist and does not collapse unrelated subjects into one recurring palette. Directed modes preserve the approved geometry and change color only.

Install

npx skills add BIAsia/voxel-icon

Or manually:

git clone https://github.com/BIAsia/voxel-icon.git
mkdir -p ~/.codex/skills/voxel-icon
rsync -a voxel-icon/skill/voxel-icon/ ~/.codex/skills/voxel-icon/
python3 -m pip install -r ~/.codex/skills/voxel-icon/scripts/requirements.txt

Restart or reload Codex after installation so the Skill can be discovered.

Use

Use $voxel-icon to turn 🎧 into a native-palette voxel icon.
Use $voxel-icon to create a directed-palette voxel icon of a camera.
Use $voxel-icon to turn the approved alarm clock into a four-frame loop.

If no palette or motion mode is specified, the Skill uses palette_mode: native and output_mode: still.

Deterministic utilities

Normalize an accepted still without rerendering its subject:

python3 skill/voxel-icon/scripts/normalize-gray-background.py INPUT.png OUTPUT.png

Assemble three complete generated RGB keyframes into a verified four-frame GIF and WebP loop:

python3 skill/voxel-icon/scripts/build-generated-loop.py \
  BASE.png POSE_FORWARD.png POSE_BACK.png OUTPUT_DIR \
  --moving-part first_part \
  --moving-part second_part

The assembler copies complete frames without masks, inpainting, local compositing, recoloring, or geometry repair.

License

See LICENSE.md — skill code is MIT; the free icons are free for personal and commercial use, no redistribution as a pack.

Links

• Icon wall — https://voxel-icon.vercel.app
• Packs — https://voxel-icon.vercel.app/price.html
• X — https://x.com/mona_biasia