Skip to content
Back to search

voxel-icon

Voxel Icon — free 3D voxel icon pack plus an agent skill that generates matching icons with GPT Image 2

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/biasia--voxel-icon/badge.svg)](/listings/biasia--voxel-icon)

HTML

<a href="/listings/biasia--voxel-icon"><img src="/api/listings/biasia--voxel-icon/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 89 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Voxel Icon
  2. The free tier of [voxel-obj](https://voxel-icon.vercel.app): a self-contained Codex Skill for generating clean, playful, low-density isometric voxel icons, plus 30 free icons from the pool.
  3. ![Voxel Icon generation process](docs/voxel-icon-process.gif)
  4. ## What's in this repository
  5. | Part | Contents |
  6. | --- | --- |
  7. | [`skill/voxel-icon`](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. |
  8. | [`icons/`](icons/) | 30 free static icons — 15 subjects × 2 palettes (native + directed), 1254 px PNG on the standard `#F4F4F4` background. See [MANIFEST.md](MANIFEST.md). |
  9. 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**
  10. ## What the art Skill produces
  11. - One isolated subject built from a small number of large rectilinear blocks.
  12. - A fixed orthographic three-quarter camera and shared coarse base-module scale.
  13. - Opaque polished face-lit acrylic with broad whole-face highlights, not edge shine.
  14. - A suspended composition with weak or absent external shadow.
  15. - An opaque RGB output with exact `#F4F4F4` background.
  16. - Optional four-frame `rest → forward → rest → back` physical-motion loops with fixed connections and real 3D pose changes.
  17. ## Palette modes
  18. | Mode | Behavior |
  19. | --- | --- |
  20. | `native` | Default. Preserves the source object or emoji's complete recognizable component colors and functional black/white. |
  21. | `directed` | Opt-in. Selects one complete relationship from the bundled 40-preset Oreo-derived registry. |
  22. | `directed-aggressive` | Opt-in. Allocates colors across distinct real layers while keeping every continuous face flat. |
  23. 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.
  24. ## Install
  25. ```bash
  26. npx skills add BIAsia/voxel-icon
  27. ```
  28. Or manually:
  29. ```bash
  30. git clone https://github.com/BIAsia/voxel-icon.git
  31. mkdir -p ~/.codex/skills/voxel-icon
  32. rsync -a voxel-icon/skill/voxel-icon/ ~/.codex/skills/voxel-icon/
  33. python3 -m pip install -r ~/.codex/skills/voxel-icon/scripts/requirements.txt
  34. ```
  35. Restart or reload Codex after installation so the Skill can be discovered.
  36. ## Use
  37. ```text
  38. Use $voxel-icon to turn 🎧 into a native-palette voxel icon.
  39. Use $voxel-icon to create a directed-palette voxel icon of a camera.
  40. Use $voxel-icon to turn the approved alarm clock into a four-frame loop.
  41. ```
  42. If no palette or motion mode is specified, the Skill uses `palette_mode: native` and `output_mode: still`.
  43. ## Deterministic utilities
  44. Normalize an accepted still without rerendering its subject:
  45. ```bash
  46. python3 skill/voxel-icon/scripts/normalize-gray-background.py INPUT.png OUTPUT.png
  47. ```
  48. Assemble three complete generated RGB keyframes into a verified four-frame GIF and WebP loop:
  49. ```bash
  50. python3 skill/voxel-icon/scripts/build-generated-loop.py \
  51. BASE.png POSE_FORWARD.png POSE_BACK.png OUTPUT_DIR \
  52. --moving-part first_part \
  53. --moving-part second_part
  54. ```
  55. The assembler copies complete frames without masks, inpainting, local compositing, recoloring, or geometry repair.
  56. ## License
  57. See [LICENSE.md](LICENSE.md) — skill code is MIT; the free icons are free for personal and commercial use, no redistribution as a pack.
  58. ## Links
  59. - Icon wall — https://voxel-icon.vercel.app
  60. - Packs — https://voxel-icon.vercel.app/price.html
  61. - X — https://x.com/mona_biasia

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.