Skip to content
Back to search

aseprite-ai-artist

Your coding agent paints pixel art in the Aseprite window you already have open. MCP server + skills for Claude Code, omp, Codex, Gemini CLI and Cursor — draws, looks at its work, animates and exports. Gallery and benchmark: pixeli.pebbly.space

Safety scan

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

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/with-pebbly/aseprite-ai-artist with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/with-pebbly/aseprite-ai-artist'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/with-pebbly--aseprite-ai-artist/badge.svg)](/listings/with-pebbly--aseprite-ai-artist)

HTML

<a href="/listings/with-pebbly--aseprite-ai-artist"><img src="/api/listings/with-pebbly--aseprite-ai-artist/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.

You need [Aseprite](https://www.aseprite.org/) 1.3+ and Node 22.6+ (macOS, Linux or Windows).

**1. The Aseprite extension** — then quit and reopen Aseprite:

npx @pebbly/aseprite-ai-artist install-extension

**2. Your agent:**

<details open> <summary><b>Claude Code</b></summary>

/plugin marketplace add with-pebbly/aseprite-ai-artist
/plugin install aseprite@aseprite-ai-artist

</details>

<details> <summary><b>omp</b></summary>

omp plugin marketplace add with-pebbly/aseprite-ai-artist
omp plugin install aseprite@aseprite-ai-artist

</details>

<details> <summary><b>Codex, Gemini, Cursor, VS Code, Windsurf</b></summary>

npx @pebbly/aseprite-ai-artist install codex      # or gemini, cursor, --all

Your config is backed up first; `--dry-run` shows the change.

</details>

**3. Check it** — restart your agent, then:

npx @pebbly/aseprite-ai-artist doctor

All ticks means you're ready. Updating? Run step 1 again. Odd setups (Steam, custom folders, Windows paths) are in [docs/INSTALL.md](docs/INSTALL.md).

<details> <summary><b>No window? Headless mode</b></summary>

For CI or a batch of assets, the server can run Aseprite itself with no window:

npx @pebbly/aseprite-ai-artist serve --headless --aseprite /path/to/aseprite

Nothing is on disk until the agent saves, and it never touches a file your editor has open. It is never a fallback: if your window isn't attached, the agent asks instead of quietly switching.

</details>

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.

.claude-plugin/marketplace.json · Manifest · 16 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "aseprite-ai-artist",
  3. "displayName": "Aseprite AI Artist",
  4. "description": "Agent-native control layer for Aseprite: live drawing over MCP, an encoded pixel-art rulebook, /aseprite:* workflows and specialist subagents.",
  5. "owner": {
  6. "name": "with-pebbly",
  7. "url": "https://github.com/with-pebbly"
  8. },
  9. "plugins": [
  10. {
  11. "name": "aseprite",
  12. "source": "./",
  13. "description": "Draw pixel art in a live Aseprite window: compact MCP tool surface, pixel-art rules, /aseprite:* skills, review/palette/rig/animation agents."
  14. }
  15. ]
  16. }
README.md · README · 274 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="docs/media/rainy-bookshop.gif" alt="A rainy night in Japan, filmed by a slowly swaying camera through layers of rain: a raccoon pulls a can from a vending machine, lightning flashes over the rooftops, maple leaves blow past an old bookshop where a girl in a big knit sweater reads and sips cocoa in warm lamplight" width="768">
  3. # Aseprite AI Artist
  4. ### Your coding agent, painting in the Aseprite window you already have open.
  5. Not a generated PNG. Not a file changed behind your back.
  6. The document on your screen, one pixel at a time — and every step is one Ctrl+Z.
  7. [![npm](https://img.shields.io/npm/v/@pebbly/aseprite-ai-artist?color=%23e07a3f&label=npm)](https://www.npmjs.com/package/@pebbly/aseprite-ai-artist)
  8. [![CI](https://github.com/with-pebbly/aseprite-ai-artist/actions/workflows/ci.yml/badge.svg)](https://github.com/with-pebbly/aseprite-ai-artist/actions/workflows/ci.yml)
  9. [![licence](https://img.shields.io/badge/licence-MIT-blue)](LICENSE)
  10. <sub>☔ 500×400 · 384 frames at 24 fps · 16 s · 24 layers — drawn by <b>Claude Opus 5.5</b> through this server.</sub>
  11. **[Install](#-install)** · **[How it draws](#-how-it-draws)** · **[Skills](#-skills)** · **[Gallery](https://pixeli.pebbly.space/)**
  12. </div>
  13. ---
  14. ## ✨ What it feels like
  15. > *"Draw me a 32×32 knight in the PICO-8 palette, then give him a 4-frame idle."*
  16. You type that, and watch it happen in Aseprite: a palette, a silhouette, shading,
  17. layers, a breathing idle, a tagged cycle. The agent **looks at its own work**
  18. after every step, and at the end tells you what it compromised on.
  19. You stay in charge. Don't like the helmet? Ctrl+Z, or just say so.
  20. Works with **Claude Code, omp, OpenCode, Codex CLI, Gemini CLI, Cursor, VS Code
  21. and Windsurf**. Best results so far: **Claude Opus 5.5**.
  22. ## 🚀 Install
  23. You need [Aseprite](https://www.aseprite.org/) 1.3+ and Node 22.6+ (macOS, Linux
  24. or Windows).
  25. **1. The Aseprite extension** — then quit and reopen Aseprite:
  26. ```bash
  27. npx @pebbly/aseprite-ai-artist install-extension
  28. ```
  29. **2. Your agent:**
  30. <details open>
  31. <summary><b>Claude Code</b></summary>
  32. ```
  33. /plugin marketplace add with-pebbly/aseprite-ai-artist
  34. /plugin install aseprite@aseprite-ai-artist
  35. ```
  36. </details>
  37. <details>
  38. <summary><b>omp</b></summary>
  39. ```bash
  40. omp plugin marketplace add with-pebbly/aseprite-ai-artist
  41. omp plugin install aseprite@aseprite-ai-artist
  42. ```
  43. </details>
  44. <details>
  45. <summary><b>OpenCode 2.x</b></summary>
  46. ```bash
  47. npx @pebbly/aseprite-ai-artist install opencode
  48. opencode plugin add github:with-pebbly/aseprite-ai-artist#main::path:opencode
  49. ```
  50. </details>
  51. <details>
  52. <summary><b>Codex, Gemini, Cursor, VS Code, Windsurf</b></summary>
  53. ```bash
  54. npx @pebbly/aseprite-ai-artist install codex # or gemini, cursor, --all
  55. ```
  56. Your config is backed up first; `--dry-run` shows the change.
  57. </details>
  58. **3. Check it** — restart your agent, then:
  59. ```bash
  60. npx @pebbly/aseprite-ai-artist doctor
  61. ```
  62. All ticks means you're ready. Updating? Run step 1 again. Odd setups (Steam,
  63. custom folders, Windows paths) are in [docs/INSTALL.md](docs/INSTALL.md).
  64. <details>
  65. <summary><b>No window? Headless mode</b></summary>
  66. For CI or a batch of assets, the server can run Aseprite itself with no window:
  67. ```bash
  68. npx @pebbly/aseprite-ai-artist serve --headless --aseprite /path/to/aseprite
  69. ```
  70. Nothing is on disk until the agent saves, and it never touches a file your
  71. editor has open. It is never a fallback: if your window isn't attached, the
  72. agent asks instead of quietly switching.
  73. </details>
  74. ## 🎨 How it draws
  75. Ask `/aseprite:studio` for anything and it runs the whole job:
  76. | | Stage | What happens |
  77. |---|---|---|
  78. | 1 | **Connect** | Checks Aseprite is attached and reads what's open. If it isn't, it stops — it never edits files behind your back. |
  79. | 2 | **Brief** | Only for open-ended requests: size, palette, view, light — **one** message, one answer. |
  80. | 3 | **Concept** | For anything new: writes the design down and gives you a prompt for an image model. Send back a concept sheet, or say "continue without". |
  81. | 4 | **Draw** | Silhouette first, written as a text grid (below), then shading. |
  82. | 5 | **Animate** | Splits limbs onto layers, plans key poses and timing, draws each frame, tags the cycles. |
  83. | 6 | **Review** | A separate critic who didn't draw it judges the result cold — what does it look like to someone never told? Blockers get fixed one at a time; a fix is kept only if the critic, shown both versions blind, prefers it. |
  84. | 7 | **Export** | Spritesheet + atlas, GIF or PNGs for your engine. |
  85. After every step that changed pixels, it **looks** at the result before moving on.
  86. ### 🔤 The grid loop
  87. New in 0.5.0. The agent doesn't draw with circles and rectangles — it **types
  88. the frame out**, one character per pixel, and draws that text in one call. To
  89. fix something, it reads the canvas back in the same format and changes only
  90. the characters that are wrong.
  91. <img src="docs/media/grid-loop.svg" alt="Four steps: the agent writes a pebble as rows of characters; Aseprite draws it; the agent reads it back as text and changes two characters; Aseprite draws the pebble winking" width="100%">
  92. It sees the whole shape while writing it, so silhouettes stay even, limbs keep
  93. their length between frames, and an edit never spills into its neighbours.
  94. Animation is the same trick: copy the last frame's rows, move the arm, draw.
  95. Since 0.6.0 every character stands for one palette entry, the same on every
  96. read, so a big canvas can be read and edited in pieces without the letters
  97. changing meaning between them. A grid can be as large as the canvas.
  98. Early signal, not a measurement: with the same model and prompts, the mage
  99. benchmark went 3 → 4/10 and the road 1 → 3/10; the tree stayed at 2
  100. ([compare them](https://pixeli.pebbly.space/benchmarks)).
  101. ### 📚 The pixel-art knowledge base
  102. The agent doesn't improvise a hand at 16 px or a horse's walk — it looks them up.
  103. **62 rules · ~400 pixel templates · 2006 palettes** — browse them at
  104. **[pixeli.pebbly.space/knowledge](https://pixeli.pebbly.space/knowledge)** 👀
  105. | 🧍 Craft | 🌍 World |
  106. |---|---|
  107. | `0x` **Core** — loop, palette, shading, outlines | `5x` **Creatures** — quadrupeds, birds, monsters |
  108. | `1x` **Technique** — lines, anti-aliasing, dithering | `6x` **Environments** — skies, water, tiles, buildings |
  109. | `2x` **Colour** — hue-shifted ramps, materials, light | `7x` **Objects & 3D** — perspective, isometric, props |
  110. | `3x` **Characters** — anatomy, faces, hands, clothing | `8x` **Effects & UI** — fire, magic, particles, fonts |
  111. | `4x` **Animation** — idle, walk, jumps, attacks | `9x` **Style** — console eras, tells of generated art |
  112. Every rule gives size budgets, a procedure, common mistakes and grid templates
  113. the agent pastes straight onto the canvas. Any MCP client reads them as
  114. `rules://` resources from [`rules/`](rules/).
  115. 🎨 **Palettes:** the console classics plus Lospec's 2000 most-downloaded, each
  116. credited — `preset: "endesga-32"`, or just a word of the name.
  117. ### 👀 Review by fresh eyes
  118. New in 0.8.0. The agent that drew a sprite is the worst judge of it — it
  119. knows what it meant, so it sees it. `studio` hands the result to
  120. **pixel-critic**, which first writes a cold read (what the picture shows to
  121. someone who was never told), then a scored critique. A draft ships at 7/10
  122. with nothing blocking; below that the agent fixes the one thing named,
  123. snapshotting first. Each fix goes back to the critic as a blind A/B — old and
  124. new under neutral names — and stays only if it wins, so a round can't quietly
  125. make good art worse.
  126. It costs time (roughly one more critique per round) and its effect on
  127. quality is not yet measured — the thirteen experiment runs behind it are in the
  128. [gallery](https://pixeli.pebbly.space/), next to the benchmark rows.
  129. ## 🧰 Skills
  130. `studio` picks these for you. Call one directly when you know the step you want
  131. — as `/aseprite:<name>` in Claude Code and omp, or just ask elsewhere.
  132. | Skill | For | Try |
  133. |---|---|---|
  134. | 🎬 **`studio`** | anything — it plans and runs the rest | `/aseprite:studio a fox, 32×32, sleeping loop` |
  135. | 📝 **`brief`** | a vague idea | `/aseprite:brief a cosy tavern keeper` |
  136. | 🖼️ **`concept`** | a design or storyboard before drawing | `/aseprite:concept a fire mage, 4-frame walk` |
  137. | 📄 **`new`** | a fresh document set up right | `/aseprite:new 64×64, PICO-8` |
  138. | 🎨 **`palette`** | colour: a retro look, ramps, cleanup | `/aseprite:palette give this a Game Boy look` |
  139. | ✏️ **`draw`** | making the thing, text included | `/aseprite:draw a fox curled up asleep` |
  140. | 🌗 **`shade`** | flat art that needs light | `/aseprite:shade light from the upper left` |
  141. | 🦴 **`rig`** | splitting a character for animation | `/aseprite:rig split the knight` |
  142. | 🏃 **`animate`** | walk, idle, attack cycles | `/aseprite:animate 8-frame walk cycle` |
  143. | 🧱 **`tileset`** | terrain and autotiles | `/aseprite:tileset grass-to-dirt, 16px` |
  144. | 🔍 **`review`** | an honest critique | `/aseprite:review why does this look off?` |
  145. | 🩹 **`fix`** | changing art without wrecking it | `/aseprite:fix make him more menacing` |
  146. | 📦 **`export`** | files for your engine | `/aseprite:export spritesheet for Godot` |
  147. | 🗂️ **`submit`** | sharing it in the gallery | `/aseprite:submit` |
  148. In Claude Code and omp, four specialists take stages off the main agent:
  149. **palette-smith**, **rig-builder**, **animation-director** and the read-only
  150. **pixel-critic**.
  151. ## 🏆 Which model?
  152. <a href="https://pixeli.pebbly.space/benchmarks">
  153. <picture>
  154. <source media="(prefers-color-scheme: dark)" srcset="https://pixeli.pebbly.space/leaderboard/dark.svg">
  155. <img alt="Benchmark leaderboard: every model's score out of 100, with compliance, craft, speed and coverage" src="https://pixeli.pebbly.space/leaderboard/light.svg">
  156. </picture>
  157. </a>
  158. Live from the [benchmark](https://pixeli.pebbly.space/benchmarks): every model
  159. draws the same fixed prompts and is scored against written criteria. Your
  160. model is not on it? [Send us a sprite!](gallery/README.md)
  161. ## 🗂️ Gallery and benchmark
  162. Everything drawn with the plugin — with its prompts, models and `.aseprite`
  163. source — is at **[pixeli.pebbly.space](https://pixeli.pebbly.space/)**. The
  164. benchmark puts every model and plugin version through the same three fixed
  165. prompts and scores them against written criteria, and the
  166. [knowledge base](https://pixeli.pebbly.space/knowledge) shows the rulebook
  167. the agents draw by.
  168. Made something? Ask your agent for `/aseprite:submit` — it packages the files
  169. and opens the pull request.
  170. ## 🔧 Under the hood
  171. ```
  172. your agent ──MCP──▶ server ──▶ bridge ──▶ Aseprite extension
  173. ```
  174. - **18 tools, grouped by noun** (`draw`, `look`, `layer`, `frame`, `export`…)
  175. instead of ninety — every tool costs context on every turn.
  176. [Reference](docs/TOOLS.md).
  177. - **A knowledge base** in [`rules/`](rules/) — 62 files from line craft to
  178. walk cycles, with pixel templates — served over MCP, so every client gets the
  179. same craft knowledge.
  180. - **Safe by default.** Every action is one undo step. With Aseprite detached,
  181. tools refuse instead of editing files on disk. Everything binds to
  182. `127.0.0.1`. [Details](docs/ARCHITECTURE.md) · [security](SECURITY.md).
  183. ## 🛠️ Development
  184. ```bash
  185. pnpm install && pnpm run build
  186. pnpm test # TypeScript
  187. pnpm run test:extension # the Lua handlers, inside a real Aseprite
  188. pnpm gallery:check # gallery and benchmark data
  189. pnpm web:dev # the site, locally
  190. ```
  191. Read [AGENTS.md](AGENTS.md) before changing anything — it lists the rules that
  192. aren't negotiable and the Lua gotchas that already cost someone a day.
  193. ## 📜 Licence
  194. MIT — see [LICENSE](LICENSE). Aseprite is a trademark of Igara Studio S.A.; this
  195. project isn't affiliated with them.
  196. <div align="center"><sub>Made with ☕ and a lot of Ctrl+Z.</sub></div>

Ratings and comments

Sign in to rate this skill.

Sign in

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