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 星数
- 23 (GitHub 星数，统计于 2026-10-24)
- 许可证
- MIT
- 最近提交
- 2026/10/24
- 作者
- aigengame
信息来自作者的 README。 GameSkill 还没完整跑过。支持的 Agent 和安装步骤以作者文档为准。
安装
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 -g命令照搬项目 README。在本机运行前，请先看一眼仓库。
为指定 Agent 安装
| Agent | -a | 文件夹 |
|---|---|---|
| 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/ |
在命令后加 -a <参数>。以上是项目级文件夹；加 -g 则安装到你的用户目录。
包含内容
- 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
适合
- 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
不适合
- Watching the agent paint in your open Aseprite window: SPA runs Aseprite in batch mode
- Art direction: visual review stays with you
关于这个 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.
环境要求
- Aseprite, installed separately (SPA does not bundle it)
- Python 3.13+ and uv
- Node/npm for the skills CLI
相关主题
常见问题
搭配使用
作者标注的相关 Skills，或更适合相邻任务的 Skills。
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.
相似 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.