# Aseprite Assets

> Create or edit Aseprite pixel art and export PNG sprite sheets with JSON frame, tag, and timing metadata for a game engine.

- Skill: `whitetowerai/aseprite-assets` (Agent Skill)
- Install (CLI): `npx get-skill add whitetowerai/aseprite-assets`
- Raw SKILL.md: https://api.skillmd.com/api/skills/whitetowerai/aseprite-assets/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: WhiteTowerAI (https://skillmd.com/u/whitetowerai)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/whitetowerai/aseprite-assets

---


# Aseprite Assets

Use the installed CLI: find it on PATH or in the app's install folder. On macOS it is inside the app bundle, commonly `/Applications/Aseprite.app/Contents/MacOS/aseprite`; on Windows it is `Aseprite.exe`. On Windows the install can be on any drive: also check Start menu shortcuts and their targets (`%ProgramData%` and `%APPDATA%` under `Microsoft/Windows/Start Menu/Programs`) and each Steam library listed in `<Steam>/steamapps/libraryfolders.vdf` (`steamapps/common/Aseprite`). If none is found, ask the user for the executable's path instead of reporting it as not installed. Check `--version` and `--help` before relying on version-specific options.

Keep the editable `.aseprite` or `.ase` source separate from runtime exports and never save over it while exporting. For repeatable edits to layers, frames, tags, or palettes, run a Lua script with `--batch --script <FILE>`. Preserve existing layers, tags, slices, and frame durations outside the requested change.

## Export

Match the engine's loader first: packed atlases need per-frame rectangles, while fixed-grid loaders need uniform cells (`--sheet-type rows`, no `--trim`). A packed export with full metadata:

```text
<ASEPRITE> --batch <SOURCE.aseprite> --sheet-type packed --sheet <OUT.png> --data <OUT.json> --format json-array --list-tags --list-slices
```

The CLI overwrites the `--sheet` and `--data` targets without asking.

## Verify

Parse the JSON and check that every frame rectangle lies inside the sheet and every tag references existing frames. Load the sheet through the engine's real loader and check frame timing, transparency, pivots, and tag playback in the running game.

