pixel-art

Convert images into retro pixel art PNGs and animate them into MP4 or GIF videos.

Updated May 13, 2026
One-click install
npx skills add https://github.com/superfhp/lumi-agent-body --skill pixel-art-superfhp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/superfhp/lumi-agent-body/tree/main/skills/creative/pixel-art
Command: npx skills add https://github.com/superfhp/lumi-agent-body --skill pixel-art-superfhp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow, ffmpeg, and includes scripts (resource) and references (resource) components.

What problem does it solve? Turning ordinary photos or generated images into era-accurate retro pixel art normally requires manual palette work and specialized editors. This Skill automates the full pipeline: quantizing any image against authentic hardware palettes (NES, Game Boy, PICO-8, C64) with Floyd-Steinberg dithering, then optionally overlaying procedural animations like rain, fireflies, or snow to produce looping MP4 or GIF clips. ## Core Features & Use Cases - Preset-based pixel conversion: 14 presets spanning arcade, SNES, NES, Game Boy, PICO-8, C64, Apple II, CRT monochrome, neon, and pastel looks, with overridable palette and block size. - 28 named palettes: Hardware-accurate and artistic RGB palettes available for any conversion via the palette parameter. - Procedural video animation: 12 scenes (night, storm, snow, fire, underwater, and more) overlay particle effects onto the pixel-art frame and encode to MP4 via ffmpeg, with optional GIF export. - Use Case: A user wants a Game Boy-style avatar for social media with a looping night-sky animation. The Skill converts their photo with the gameboy preset, then animates it with the night scene into a shareable MP4 and GIF. ## Quick Start Ask the assistant to convert your image into pixel art with a specific preset such as nes or gameboy, and optionally request an animated scene like night or snow to get an MP4 and GIF.

Frequently Asked Questions about pixel-art

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert an image to pixel art in Python?▼

Call the pixel_art function with an input path, output path, and a preset such as arcade, nes, or gameboy. It enhances contrast, posterizes, downscales with nearest-neighbor, quantizes with Floyd-Steinberg dithering, and upscales back to produce the pixel-art PNG.

How do I make an animated pixel art video or GIF?▼

Run pixel_art_video on a pixel-art PNG with a scene name like night, storm, or snow, plus duration and fps. It overlays procedural particle effects frame by frame and encodes to MP4 via ffmpeg, with an optional GIF when export_gif is enabled.

What retro palettes are available for pixel art conversion?▼

There are 28 named palettes including NES, C64, ZX Spectrum, Apple II, Game Boy Original and Pocket, PICO-8, Teletext, MSX, MS Paint, and monochrome variants, plus ten artistic palettes like neon, pastel, and sunset. Pass any name as the palette parameter.

Does pixel art video generation require ffmpeg?▼

Yes, ffmpeg must be on PATH for video encoding; the script raises a RuntimeError if it is missing. Still image conversion with pixel_art only needs Pillow, so ffmpeg is only required when producing MP4 or GIF output.

Why does my pixel art look wrong on small source images?▼

Sources under about 100 pixels wide collapse under 8-10px block sizes, destroying detail. Upscale the source image first, or choose a preset with a smaller block size such as snes (4px) or pico8 (6px).