pixel-art

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

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/xiaoshan1234/ai-skill --skill pixel-art-xiaoshan1234
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/xiaoshan1234/ai-skill/tree/main/origin/pixel-art
Command: npx skills add https://github.com/xiaoshan1234/ai-skill --skill pixel-art-xiaoshan1234

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 frame-by-frame animation. This Skill automates the full pipeline: image-to-pixel-art conversion with hardware-accurate palettes, plus optional procedural animation overlays exported as MP4 or GIF. ## Core Features & Use Cases - Pixel Art Conversion: Transform any image into pixel art using Floyd-Steinberg dithering, with 14 presets spanning NES, Game Boy, PICO-8, C64, SNES, arcade, and more, backed by 28 named hardware and artistic palettes. - Animated Scenes: Overlay 12 procedural effects (rain, snow, fireflies, embers, lightning, and more) combined into 12 themed scenes, then 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 snow animation. The Skill converts their photo with the gameboy preset, then applies the snow scene to produce a 6-second MP4 and GIF. ## Quick Start Ask the assistant to convert your image into pixel art with a specific preset like NES or Game Boy, and optionally request an animated scene such as night or snow to get an MP4 or 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?

Use the pixel_art() function with an input path, output path, and a preset such as nes, gameboy, or arcade. 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 animate a pixel art image into an MP4 video?

Call pixel_art_video() with your pixel art PNG, an output path, and a scene name like night, snow, or storm. It overlays procedural particle effects frame by frame and encodes the result with ffmpeg, with an optional GIF export flag.

What retro console 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, and MS Paint, plus 10 artistic palettes like neon cyber and pastel dream. Pass the palette name to override any preset.

Does pixel art video generation require ffmpeg?

Yes, ffmpeg must be on the system PATH for video encoding; the script raises a RuntimeError if it is missing. The still-image pixel_art() conversion only needs Pillow and works without ffmpeg.

Why does my pixel art look wrong with very small source images?

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