pixel-art

Convert images into retro pixel art with Floyd-Steinberg dithering and hardware palettes.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/AissenLiu/EasyHermes --skill pixel-art-aissenliu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pixel-art
Source: https://github.com/AissenLiu/EasyHermes/tree/main/hermes-agent/skills/creative/pixel-art
Command: npx skills add https://github.com/AissenLiu/EasyHermes --skill pixel-art-aissenliu

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Converting images into retro pixel art and animated clips saves time, enabling artists and developers to create nostalgic visuals without manual pixel-by-pixel rendering.

Core Features & Use Cases

  • Pixel-art conversion using Floyd-Steinberg dithering with hardware palettes (NES, Game Boy, SNES, C64, etc.).
  • Optional animation: overlay procedural scenes to produce short MP4 or GIF sequences.
  • Flexible workflow: Python API and CLI with presets (arcade, snes, nes, gameboy, pico8, c64, mono-green, neon, etc.) and custom palettes.

Quick Start

Provide a source image and run the pixel_art tool to generate a pixel-art PNG (and optionally use pixel_art_video to create an animated 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 with dithering in Python?

To convert an image to pixel art, the tool applies Floyd-Steinberg dithering using hardware palettes like NES, Game Boy, or SNES. It leverages the Pillow library for image processing to produce retro pixel-art PNGs directly from source images.

Can I create pixel art animations and export them as MP4 or GIF?

Yes, pixel art animations can be exported as MP4 or GIF. The tool overlays procedural scenes onto static pixel art and uses ffmpeg on PATH for video encoding, generating short animated sequences alongside standard PNG output.

Do I need ffmpeg installed to generate pixel art images?

You do not need ffmpeg to generate static pixel art PNGs, as that relies solely on the Pillow dependency. However, ffmpeg must be installed on your system PATH to encode and export animated pixel art video sequences.

What preset color palettes are available for pixel art conversion?

Available preset color palettes for pixel art conversion include arcade, snes, nes, gameboy, pico8, c64, mono-green, and neon. You can also define custom palettes via the Python API or CLI to match specific hardware color schemes.

How does Floyd-Steinberg dithering work for retro pixel art?

Floyd-Steinberg dithering works for retro pixel art by distributing quantization errors to neighboring pixels, simulating color depth on limited hardware palettes. This creates the classic retro aesthetic without requiring manual pixel-by-pixel rendering.

Can I use a custom color palette instead of the hardware presets?

Yes, you can use a custom color palette instead of hardware presets. The Python API and CLI both support custom palette definitions, allowing you to apply unique color schemes to your pixel art conversion alongside the built-in presets.