voxel-icon Voxel icon skill for GPT Image 2

Generate
3D icons

Tutorial · voxel-icon skill
About five minutes

The idea

One skill turns a general image model into a 3D icon generator with a fixed style: whatever subject you ask for, it comes back as a few large acrylic blocks on the same grid, from the same camera.

Image models can draw anything, which is exactly the problem for icon work — ask twice and you get two styles. voxel-icon is an agent skill for GPT Image 2 that closes that gap. It carries the style contract, the palette registry, and the calibration references, so your agent generates icons that sit next to each other like one family. This page walks through generating your own; the free set shows where it lands.


(01) Install

Add the skill to any coding agent that supports the skills format.

npx skills add BIAsia/voxel-icon

That single install ships everything the agent needs: the style contract for still icons, a 40-preset palette registry, two internally generated calibration images, and two post-processing scripts (Pillow + NumPy) that normalize every render to an exact #F4F4F4 background. Nothing else to configure — the skill is self-contained and public on GitHub.


(02) Generate

Ask for a subject — a toaster, a crown, an hourglass — as a voxel icon. The skill handles the rest.

A prompt as plain as “generate a voxel icon of a toaster” is enough. The skill constrains the model to one isolated subject built from a small number of large rectilinear blocks, shot from a fixed orthographic three-quarter camera, in polished face-lit acrylic with broad whole-face highlights. The subject floats with barely any shadow, and the background comes out #F4F4F4 every time — that consistency is what makes a set of one-off generations read as one icon family.

voxel-icon generation process — prompt to finished 3D voxel icon
The generation flow, prompt to calibrated still — native palette.

(03) Recolor

Native keeps the object's own colors. Directed recolors the same geometry with one preset relationship.

By default every subject keeps its recognizable component colors — a red toolbox stays red. Ask for directed mode and the skill picks one complete relationship from its 40 bundled presets and recolors the approved geometry without touching its shape; every icon on this site ships in both variants. An aggressive mode goes further, mapping preset colors across the object's distinct real layers.


(04) Animate

Motion is opt-in: a four-frame rest → forward → rest → back loop with real 3D pose changes.

Ask for a loop and the skill generates four complete keyframes — connections stay fixed, the pose actually moves in 3D — then the bundled scripts assemble and verify a GIF and WebP. No masks, no inpainting. The animated tiles on the wall are exactly these loops.


Same subjects, same model — top row without the skill, bottom row with it.
GPT Image 2 output without the voxel-icon skill versus with it — telephone, camera, light bulb

What is an icon skill?An agent skill is a folder of instructions, references, and scripts that a coding agent installs and follows. voxel-icon is one that art-directs GPT Image 2: it pins the camera, the block scale, the material, and the background, so every icon the agent generates lands in the same 3D voxel style.
Do I need GPT Image 2?Yes. The skill's prompts and calibration references target GPT Image 2, so your agent needs access to it for image generation. The skill itself is free and public on GitHub.
Can I use the icons commercially?Icons from the packs ship with a personal + commercial license. Icons you generate yourself with the skill follow your image-model provider's terms.
How do I get transparent PNGs?The skill renders on an exact #F4F4F4 background. The icon packs ship the pool as transparent PNGs at 1254 px, ready to drop on any surface.

Prefer ready-made? The same skill has already filled a pool — 30 icons free, the rest as one-time packs.

The free set15 subjects

Unlock all 1,100 icons

Both palettes · 303 Three.js models · every future icon included · one-time

Unlock the full pack — $79