sprite-stacking
Agent skill: turn four pixel art views into fake-3D sprites you can spin. Works with Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Pi.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/danielwh2--sprite-stacking)HTML
<a href="/listings/danielwh2--sprite-stacking"><img src="/api/listings/danielwh2--sprite-stacking/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills add danielwh2/sprite-stacking
Installs to the current project. Add `-g` for every project, `-a claude-code` (or `codex`, `cursor`, ...) to pick an agent. Uses the [skills CLI](https://github.com/vercel-labs/skills), Node 22.20 or later.
Or copy `skills/sprite-stacking` into your agent's skills folder:
| Agent | Folder | | --- | --- | | Claude Code | `~/.claude/skills/` | | Codex, Cursor, OpenCode, Gemini CLI, Pi | `~/.agents/skills/` |
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 · 87 lines
- # sprite-stacking
- An agent skill that turns four pixel art views into fake-3D sprites you can spin. By Daniel White.
- 
- 
- 
- 
- 
- ## Install
- ```bash
- npx skills add danielwh2/sprite-stacking
- ```
- Installs to the current project. Add `-g` for every project, `-a claude-code` (or `codex`, `cursor`, ...) to pick an agent. Uses the [skills CLI](https://github.com/vercel-labs/skills), Node 22.20 or later.
- Or copy `skills/sprite-stacking` into your agent's skills folder:
- | Agent | Folder |
- | --- | --- |
- | Claude Code | `~/.claude/skills/` |
- | Codex, Cursor, OpenCode, Gemini CLI, Pi | `~/.agents/skills/` |
- ## Use
- Ask your agent:
- - "Make a rotatable pixel art car."
- - "Sprite stack this 4-view sheet and give me a turntable."
- - "Add a fake 3D pixel art tree to my Godot game."
- No image generator? The agent draws the views itself in a short Python script.
- ## How it works
- 
- 1. **Views:** top, side, front and back, orthographic, one row.
- 2. **Carve:** a voxel survives only where all four views cover it.
- 3. **Slices:** the volume is cut into a strip of flat layers, ground first.
- 4. **Render:** each layer is rotated, squashed for pitch and lifted 1 px.
- ## Slicer CLI
- ```bash
- python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
- --slices 36 --preview check.png --html viewer.html
- ```
- - `--slices N`: layer count. 15-20 chunky, 32-48 detailed.
- - `--order reading`: force TOP, SIDE, FRONT, BACK. Default matches views by proportion.
- - `--round`: towers, balloons, pots carve round, not square.
- - `--side-nose right`: the side view faces right.
- - `--colours N`: shared palette size, `0` keeps every colour.
- - `--normals path.png`: save a matching 3D normal-map slice strip.
- - `--emissive path.png`: save an auto-detected emissive mask strip (headlights, windows, neon).
- ## Viewer
- `--html` writes a standalone page:
- - **Modes:** Turntable, **Scene** (Living Diorama with **Neon Street** and **Meadow Island** procedural stacked props, unified Y-sorting, and multi-PNG drop / `+ Add Prop`), Slice scan, Exploded view, and **Play** mode (**Drive** with WASD/arrows + drift across infinite Street/Meadow/Grid worlds, **Wind** sway, **Shatter** & rebuild).
- - **Lighting & Weather:** Live **Time of Day** (Day → Sunset → Night with auto-emissive glow and ground light pools), draggable sun (`Shift+drag`) with projected 3D shadows, and **Weather** (**Rain** with pixel streaks, ground ripples, and wavy upside-down wet reflections; **Snow** with real-time snow cap accumulation on upward-facing voxels via `normZ`).
- - **Performance:** Vectorized NumPy carving, zero-allocation typed-array software rasterizer, and angle/lighting-keyed prop sprite caching (~0.2–1.5 ms/frame in Chrome).
- - **Export:** 16-direction baked PNG sprite sheet export. `skills/sprite-stacking/scripts/viewer.html` also opens on its own and accepts dropped slice strips.
- ## Requirements
- Python 3 with Pillow and NumPy (`pip install pillow numpy`).
- ## Contributing
- ```bash
- python3 tests/check.py
- ```
- Prints `ok`.
- ## Prior art
- Sprite stacking is a long-standing indie game technique, not invented here. This skill adds the four-view carving and the agent workflow.
- ## Licence
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.