pixel-art

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

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill pixel-art-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/creative/pixel-art
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill pixel-art-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Creating era-accurate retro pixel art from photos requires manual palette selection, dithering, and pixel-grid alignment, and adding looping animation effects like rain or fireflies normally demands frame-by-frame work. ## Core Features & Use Cases - Preset-based pixel conversion: 14 presets (arcade, NES, Game Boy, PICO-8, C64, SNES, and more) apply Floyd-Steinberg dithering against 28 named hardware and artistic palettes with configurable block size. - Procedural animation overlays: 12 particle effects (stars, rain, snow, embers, lightning, neon pulse, and more) combine into 12 scenes rendered to MP4 via ffmpeg, with optional GIF export. - Use Case: A user wants a Game Boy-style avatar with falling snow for a social post. The skill converts the photo with the gameboy preset, then animates it with the snow scene into a looping MP4 and GIF. ## Quick Start Convert my photo portrait.jpg into NES-style pixel art and animate it with the night scene into a short MP4 video.

Frequently Asked Questions about pixel-art

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

FAQPage Schema
How do I convert a photo to pixel art in Python?▼

Call pixel_art(input_path, output_path, preset="nes") after adding the scripts directory to sys.path. The function enhances contrast, posterizes, downscales with nearest-neighbor, quantizes with Floyd-Steinberg dithering, and upscales back to produce the pixelated PNG.

How to make an animated pixel art GIF or MP4?▼

Run pixel_art_video(base_image, output_path, scene="night", duration=6, export_gif=True) on a pixel-art PNG. It overlays procedural particle effects frame by frame and encodes with ffmpeg to MP4, plus an optional looping GIF.

What retro palettes are available for pixel art conversion?▼

There are 28 named palettes including NES (54 colors), Game Boy DMG, PICO-8, C64, ZX Spectrum, Apple II, MS Paint, and artistic sets like NEON_CYBER and PASTEL_DREAM. Pass any name via the palette parameter to override a preset.

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 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 (4px) or pico8 (6px).