SPA: Aseprite Automation
/spa
Aseprite automation for AI agents as a CLI, an agent skill and an MCP server: create, edit, verify and export pixel art, animations, tilesets and sprite sheets in batch mode, keeping editable .aseprite sources.
- GitHub stars
- 23 (GitHub stars as of 2026-10-24)
- License
- MIT
- Last commit
- 2026/10/24
- By
- aigengame
Listed from the author's README. GameSkill has not run this end to end yet. Agent support and install steps are as documented by the author.
Install
uv tool install --python 3.13 aseprite-automation
spa infoFor MCP, install 'aseprite-automation[mcp]' and point your client at the spa-mcp executable.
npx skills add aigengame/aseprite-automation --skill spa -gCommands are copied from the project's README. Check the repository before running anything on your machine.
Install for a specific agent
| Agents | -a | Folder |
|---|---|---|
| Claude Code | claude-code | .claude/skills/ |
| Codex | codex | .agents/skills/ |
| Cursor | cursor | .agents/skills/ |
| Gemini CLI | gemini-cli | .agents/skills/ |
| GitHub Copilot | github-copilot | .agents/skills/ |
| OpenCode | opencode | .agents/skills/ |
| Windsurf | windsurf | .windsurf/skills/ |
Add -a <flag> to the command. These are project folders; add -g to install for your user account instead.
What you get
- The spa CLI (PyPI: aseprite-automation, latest release v0.5.2)
- The spa agent skill for the create, verify, export loop
- An optional spa-mcp server with the same operations; exported PNGs come back as image content
- Commands for sprites, layers, frames, cels, tags, slices, palettes, tilesets, tilemaps, paint, filters and motion
- plan check / plan run to validate a sequence of edits before one final save
- Exports: PNG, GIF, PNG sequences, sprite sheets with JSON, tileset/map exports
- Two wizard examples with playable Godot projects
Good fit
- Scripted, repeatable pixel art and animation pipelines
- Agents that need to verify results (inspect, compare frames, validate facts)
- Delivering sprite sheets and tilesets to Godot or other engines
Not for
- Watching the agent paint in your open Aseprite window: SPA runs Aseprite in batch mode
- Art direction: visual review stays with you
About this skill
SPA ("Simple. Stable. Congruent.") gives agents one set of Aseprite operations through three doors: a shell CLI, an agent skill that teaches the create–verify–export loop, and an MCP server. Every command has a --schema, and results are structured so the agent can handle failures instead of guessing.
It covers far more than drawing: palettes and color profiles, keyed tiles, tilesets and tilemaps, selections, filters, cel motion curves, and export to sprite sheets with JSON. plan check and plan run batch several edits and check them before one final save.
The repo ships two wizard examples whose assets feed playable Godot spell-timing games, with the preparation choices and validation evidence recorded.
Related
- Aseprite AI Artist paints live in your open Aseprite window.
- Aseprite Animate for animation craft.
- Aseprite Export for engine-ready exports.
Requirements
- Aseprite, installed separately (SPA does not bundle it)
- Python 3.13+ and uv
- Node/npm for the skills CLI
Topics
FAQ
Works well with
Skills the author points to as related or as the better fit for neighbouring tasks.
Aseprite AI Artist
Your coding agent paints pixel art in the Aseprite window you already have open: draws, checks its work, animates and exports.
Aseprite Animate
Build an idle, walk, run or attack cycle from key poses, set timing that reads as motion rather than a metronome, tag it, and review it as a filmstrip.
Aseprite Export
Produce the files an engine actually consumes — spritesheets with atlases, GIFs, scaled PNGs — with the tags and layout the target needs.
Similar skills
GladeKit MCP (Unity + Godot)
One MCP server for Unity and Godot editors: 275 Unity tools, 115 Godot tools, gameplay scaffolders, screenshot checks and GLADE.md project context.
Hermes GameForge
A game-development plugin for Hermes Agent with 10 agent skills and 9 tools: SFX, music, NPC voices, pixel sprites, tilesets, low-poly 3D, web/Godot/Unity builds, a playtester that plays the build, and itch.io export. Runs offline by default.
open-game-skills
An MIT pack of about 190 SKILL.md agent skills for game design: combat feel, camera, traversal, world, validation, 2D/Spine and art pipeline, with a dispatcher and adapters for Three.js, PixiJS, Phaser, Cocos, Godot, Unity and Unreal.
Claude Code Game Studios
Turns Claude Code into a full game studio: 49 agents and 72 workflow skills arranged like a real studio hierarchy.