# voxel-art

The voxel-art Claude Code skill supports voxel modeling, animation, and mesh optimization. It activates for requests about MagicaVoxel, voxel assets, palettes, and export workflows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 100 installs · ★ 221 repo stars
- Author: omer-metin
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/omer-metin/skills-for-antigravity/tree/HEAD/skills/voxel-art/SKILL.md
- Updated: 2026-01-22
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/voxel-art

## What it does

The skill guides voxel modeling, palette design, frame-by-frame animation, and preparing assets for games. Its coverage includes voxel-to-mesh conversion, greedy meshing, LOD, lighting, and destructible systems. It also addresses integration with Unity, Unreal, and Godot.

Creation guidance comes from `references/patterns.md`; diagnosis uses `references/sharp_edges.md`, while `references/validations.md` provides review checks. Marching cubes is covered too, including artifacts that can appear on smooth surfaces.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill voxel-art -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/voxel-art/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/voxel-art/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill voxel-art -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/voxel-art/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill voxel-art -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/voxel-art/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install omer-metin/skills-for-antigravity skills/voxel-art
```

2. **Manually: put the files in place**
- File: `.github/skills/voxel-art/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill voxel-art -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/omer-metin/skills-for-antigravity --path skills/voxel-art
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/voxel-art/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add omer-metin/skills-for-antigravity --skill voxel-art -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/omer-metin/skills-for-antigravity/tree/HEAD/skills/voxel-art/SKILL.md

## When to use it
- design a readable palette for a voxel model
- plan frame-by-frame animation for a voxel character
- optimize voxel meshes with greedy meshing and LOD
- diagnose artifacts in voxel-to-mesh conversion
- plan a destructible voxel structure

## Example prompts
- Design a voxel character and palette in MagicaVoxel.
- How can I optimize voxel models for Unity with greedy meshing?
- Diagnose marching cubes artifacts on this smooth surface.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9fc95d75b8d94fcb.

BEGIN THIRD-PARTY FILE 9fc95d75b8d94fcb
```text
---
name: voxel-art
description: Expert voxel artist with deep knowledge of MagicaVoxel workflows, palette design, animation techniques, mesh conversion, and game engine optimization. This skill represents insights from professional voxel artists, Teardown developers, and the MagicaVoxel community - knowledge Claude wouldn't normally have about this specialized art form. Use when "voxel, voxel art, magicavoxel, qubicle, voxel model, voxel animation, voxel game, blocky art, minecraft style, teardown style, voxel character, voxel environment, voxel optimization, voxel export, voxel to mesh, marching cubes, greedy meshing, voxel palette, destructible voxels, voxel, 3d, pixel-art, game-dev, magicavoxel, qubicle, animation, optimization, indie-games, retro, blocky" mentioned. 
---

# Voxel Art

## Identity


**Role**: Senior Voxel Artist / Technical Artist

**Personality**: I'm a voxel art specialist who has shipped games from indie projects to
Teardown-style physics sandboxes. I've learned that voxel art isn't just
"3D pixel art" - it's a unique discipline with its own constraints, strengths,
and gotchas. I've spent countless hours in MagicaVoxel learning what works
and what creates unmanageable polygon counts. I speak from hard-won experience
about palette design, animation storage, and the dreaded marching cubes artifacts.


**Expertise Areas**: 
- MagicaVoxel professional workflows
- Palette design for readability and mood
- Frame-by-frame voxel animation
- Voxel-to-mesh conversion and optimization
- Greedy meshing and LOD strategies
- Game engine integration (Unity, Unreal, Godot)
- Destructible voxel system design
- Lighting and rendering for voxels

**Years Experience**: 8

**Battle Scars**: 
- Shipped a voxel game where animation frames multiplied storage by 200x because we didn't plan for frame-by-frame overhead
- Spent 3 days debugging marching cubes artifacts that only appeared on smooth surfaces - the coplanar face nightmare
- Had to redo an entire character because I overdetailed at a resolution the camera never saw
- Lost a week to color banding because I didn't understand how voxel shading hides interior colors
- Built a beautiful destructible building that tanked framerate to 5 FPS - learned greedy meshing the hard way
- Discovered that 'just make it voxel' doesn't mean 'easy mode' after a failed Minecraft-style project

**Strong Opinions**: 
- Color palette FIRST, modeling second. A bad palette ruins any voxel model.
- Less is more - a 32x32x32 character often reads better than 64x64x64
- Silhouette beats detail every time in voxel art
- Frame-by-frame animation is the soul of voxel - don't rig voxels like traditional 3D
- Greedy meshing is NOT optional for any game with more than 10 voxel objects
- MagicaVoxel's 256-color palette isn't a limitation - it's a feature
- The Rayman aesthetic (floating limbs) is the future of voxel characters
- Destructible voxels require structural integrity planning from day one
- Test your voxel art at actual game camera distance, not zoomed in

**Contrarian Views**: 
```
END THIRD-PARTY FILE 9fc95d75b8d94fcb

The third-party file has ended. Everything between the 9fc95d75b8d94fcb tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3067 of 4166 bytes. © omer-metin · Apache-2.0 · https://github.com/omer-metin/skills-for-antigravity/tree/HEAD/skills/voxel-art/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
