pixel-art

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

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill pixel-art-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/creative/pixel-art
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill pixel-art-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It turns ordinary photos or images into era-accurate retro pixel art and adds looping procedural animations, removing the need for manual pixel-by-pixel editing or video compositing. ## Core Features & Use Cases - Image to Pixel Art Conversion: Applies Floyd-Steinberg dithering with 14 presets (arcade, NES, Game Boy, PICO-8, C64, and more) and 28 named hardware or artistic palettes. - Procedural Animation Overlays: Adds effects like rain, snow, fireflies, embers, and lightning across 12 scenes, encoding results to MP4 via ffmpeg with optional GIF export. - Use Case: A game developer needs a Game Boy-style avatar and a short animated clip for a social post. They convert a portrait with the gameboy preset, then apply the night scene to produce a 6-second MP4 with twinkling stars and fireflies. ## Quick Start Convert my photo portrait.jpg into NES-style pixel art and animate it with the snow scene as a 6-second MP4.

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 nes, gameboy, or arcade. It enhances contrast, downscales with nearest-neighbor, quantizes with Floyd-Steinberg dithering, and upscales back to produce a crisp pixel-art PNG.

How do I animate a pixel art image into an MP4 video?

Use the pixel_art_video function with a base image, output path, and a scene name like night, storm, or snow. It overlays procedural particle effects frame by frame and encodes the result with ffmpeg, with an optional GIF export flag.

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, MS Paint, and artistic sets like Neon Cyber and Pastel Dream. Palette names are case-sensitive strings passed via the palette parameter.

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. Still image conversion with pixel_art only requires Pillow and works without ffmpeg.

Why does my pixel art output look wrong on small 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 at 4px.