pixel-art

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

Updated May 4, 2026
One-click install
npx skills add https://github.com/Junkfooooood/hermes-governance --skill pixel-art-junkfooooood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/Junkfooooood/hermes-governance/tree/main/skills/creative/pixel-art
Command: npx skills add https://github.com/Junkfooooood/hermes-governance --skill pixel-art-junkfooooood

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Turning 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: quantize any image against hardware-accurate palettes (NES, Game Boy, PICO-8, C64) with Floyd-Steinberg dithering, then optionally overlay procedural particle animations and encode the result as MP4 or GIF. ## Core Features & Use Cases - Preset-based pixel conversion: 14 presets (arcade, snes, nes, gameboy, pico8, c64, neon, pastel, and more) controlling contrast, posterization, block size, and palette in one call. - 28 named palettes: Hardware-accurate (NES 54-color, Game Boy 4-shade, ZX Spectrum, Apple II) plus artistic gradients, overridable per invocation. - Procedural video animation: 12 scenes (night, storm, snow, fire, underwater, urban) layering effects like rain, fireflies, embers, and lightning onto the pixel-art frame, encoded via ffmpeg to MP4 with optional GIF export. - Use Case: A user wants a Game Boy-style avatar with falling snow for a social post — run pixel_art() with the gameboy preset, then pixel_art_video() with the snow scene to get a looping MP4 and GIF. ## Quick Start Ask the assistant to convert your image into NES-style pixel art and animate it with a night scene using the pixel-art skill.

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. It enhances contrast, posterizes, downscales with NEAREST resampling, quantizes with Floyd-Steinberg dithering, and upscales back to produce a crisp pixel-art PNG.

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

Use pixel_art_video(base_image, output_path, scene="night", duration=6, fps=15) after converting the image. It overlays procedural particle effects per frame and encodes to MP4 via ffmpeg, with an optional GIF export using palettegen and paletteuse filters.

What retro palettes are available for pixel art conversion?

There are 28 named palettes including NES (54 colors), Game Boy original and pocket, PICO-8, C64, ZX Spectrum, Apple II, MSX, and MS Paint, plus 10 artistic gradients like NEON_CYBER and PASTEL_DREAM. Pass the name via the palette parameter or pick a preset that selects one.

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. The still-image conversion via pixel_art() only needs Pillow and works without ffmpeg.

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