pxl-pixel-art

Installation
SKILL.md

pxl: pixel art as code

You write a small .px.js file; pxl renders PNGs and upscaled previews you can look at. The DSL is built to avoid writing pixels twice: mirroring, auto-outline, palette-swap variants, reusable parts, primitives, brushes and tilemaps. Needs Node ≥ 22.18. No install step.

PXL below means node <this skill's directory>/bin/pxl.js.

Workflow

  1. Write art.px.js (start from the template below; examples in examples/).
  2. Build only what you're working on: PXL build art.px.js --only slime,heart
  3. Look at it: read out/_preview/<name>.png (upscaled, checkerboard = transparent, grid every pixel, darker every 8). For exact pixel fixes use PXL ascii art.px.js <name> (keys + x/y rulers); it's cheaper than an image.
  4. Fix with small edits (a grid(x, y, ...) patch, one op) and rebuild. Repeat.
  5. If the user wants to watch: start PXL serve art.px.js in the background and give them the URL. It rebuilds on every save and replays the edited asset's painting steps; it also writes the same out/ files, so keep reading previews as usual.
Installs
54
GitHub Stars
685
First Seen
Oct 15, 2026