pixel-art

Convert images into retro pixel art PNGs and animated MP4 or GIF scenes.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill pixel-art-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/creative/pixel-art
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill pixel-art-avatar-arts

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 optionally animates them into short looping videos, removing the need for manual pixel-by-pixel editing or palette research. ## Core Features & Use Cases - Preset-based pixel conversion: 14 presets (arcade, snes, nes, gameboy, pico8, c64, neon, pastel, and more) apply Floyd-Steinberg dithering against 28 named hardware and artistic palettes. - Procedural animation overlays: 12 scenes (night, storm, snow, fire, underwater, urban, etc.) layer effects like rain, fireflies, embers, and lightning onto the pixel-art frame, encoded to MP4 with optional GIF export via ffmpeg. - Use Case: A game developer needs a Game Boy-style avatar for a profile page. They run the gameboy preset on a photo to get a 4-shade green pixel PNG, then animate it with the night scene into a 6-second looping MP4 for a social post. ## Quick Start Convert my photo portrait.jpg into NES-style pixel art and animate it with falling snow 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 an image to pixel art in Python?

Call pixel_art(input_path, output_path, preset="nes") from the pixel_art.py script, or run it as a CLI with python pixel_art.py in.png out.png --preset nes. It downscales with NEAREST resampling and quantizes with Floyd-Steinberg dithering against the preset palette.

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

Use pixel_art_video(base_image, output_path, scene="night", duration=6, fps=15) after converting the base image. It overlays procedural effects like stars, rain, or snowflakes frame by frame and encodes with ffmpeg libx264, with an optional GIF export flag.

What retro palettes and presets are available for pixel art conversion?

There are 14 presets including arcade, snes, nes, gameboy, pico8, c64, apple2, neon, and pastel, backed by 28 named palettes such as NES, GAMEBOY_ORIGINAL, PICO_8, ZX_SPECTRUM, and MONO_AMBER. Any preset's palette, block size, or enhancement values can be overridden.

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