Agent skill

Pixel Art

by mateaix in mateaix/mateclaw

Pixel art w/ era palettes (NES, Game Boy, PICO-8). An agent skill from mateaix/mateclaw.

Apache-2.0Auto-check passedGame Development

Install Pixel Art

skills CLI
$ npx skills add mateaix/mateclaw --skill pixel-art -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mateaix/mateclaw pixel-art --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mateaix/mateclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/mateclaw-server/src/main/resources/skills/pixel-art .claude/skills/pixel-art && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pixel-art
GitHub stars
1.1k
Used in
5 other repos
Token cost
~1.8k tokens
SKILL.md length
753 words
Files
7 (incl. scripts, references)
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Pixel art w/ era palettes (NES, Game Boy, PICO-8). An agent skill from mateaix/mateclaw.

  • Works in 3 steps: Offer a style → Offer animation (optional) → Generate
  • Tasks that involve Sprites and pixel art
  • SKILL.md covers When to Use, Workflow, Preset Catalog and Scene Catalog (for video), plus 6 more sections
  • Runs Python scripts from its folder; calls python and pip

What it does

Pixel Art is an agent skill from mateaix/mateclaw. Pixel art w/ era palettes (NES, Game Boy, PICO-8).

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `ATTRIBUTION.md`, `references/palettes.md` and `scripts/__init__.py`).

It sits in Game Development, covering Sprites and pixel art. The repository describes itself as: 🤖 MateClaw — Your second brain with Multi-Agent Orchestration, MCP Protocol, Skills & Memory, Dream, and Multi-Channel Support. Built on Spring AI Alibaba. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Sprites and pixel art

Example prompts

  • “/pixel-art”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Offer a style
  2. Offer animation (optional)
  3. Generate

What it can do on your machine

Read from SKILL.md and the folder at commit 3b5f7de. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pixel Art loads about 1.8k tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 15 tokens; SKILL.md has 753 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~15
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from mateaix/mateclaw at commit 3b5f7de, republished under its Apache-2.0 licence (© mateaix). 753 words, ~1,826 tokens.

Download SKILL.mdSave it as .claude/skills/pixel-art/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
pixel-art
description
Pixel art w/ era palettes (NES, Game Boy, PICO-8).
version
2.0.0
tags
creative, pixel-art, arcade, snes, nes, gameboy, retro, image, video
author
ported

Pixel Art

Convert any image into retro pixel art, then optionally animate it into a short MP4 or GIF with era-appropriate effects (rain, fireflies, snow, embers).

Two scripts ship with this skill:

  • scripts/pixel_art.py — photo → pixel-art PNG (Floyd-Steinberg dithering)
  • scripts/pixel_art_video.py — pixel-art PNG → animated MP4 (+ optional GIF)

Each is importable or runnable directly. Presets snap to hardware palettes when you want era-accurate colors (NES, Game Boy, PICO-8, etc.), or use adaptive N-color quantization for arcade/SNES-style looks.

When to Use

  • User wants retro pixel art from a source image
  • User asks for NES / Game Boy / PICO-8 / C64 / arcade / SNES styling
  • User wants a short looping animation (rain scene, night sky, snow, etc.)
  • Posters, album covers, social posts, sprites, characters, avatars

Workflow

Before generating, confirm the style with the user. Different presets produce very different outputs and regenerating is costly.

Step 1 — Offer a style

Call clarify with 4 representative presets. Pick the set based on what the user asked for — don't just dump all 14.

Default menu when the user's intent is unclear:

python
clarify(
    question="Which pixel-art style do you want?",
    choices=[
        "arcade — bold, chunky 80s cabinet feel (16 colors, 8px)",
        "nes — Nintendo 8-bit hardware palette (54 colors, 8px)",
        "gameboy — 4-shade green Game Boy DMG",
        "snes — cleaner 16-bit look (32 colors, 4px)",
    ],
)

When the user already named an era (e.g. "80s arcade", "Gameboy"), skip clarify and use the matching preset directly.

Step 2 — Offer animation (optional)

If the user asked for a video/GIF, or the output might benefit from motion, ask which scene:

python
clarify(
    question="Want to animate it? Pick a scene or skip.",
    choices=[
        "night — stars + fireflies + leaves",
        "urban — rain + neon pulse",
        "snow — falling snowflakes",
        "skip — just the image",
    ],
)

Do NOT call clarify more than twice in a row. One for style, one for scene if animation is on the table. If the user explicitly asked for a specific style and scene in their message, skip clarify entirely.

Step 3 — Generate

Run pixel_art() first; if animation was requested, chain into pixel_art_video() on the result.

Preset Catalog

PresetEraPaletteBlockBest for
arcade80s arcadeadaptive 168pxBold posters, hero art
snes16-bitadaptive 324pxCharacters, detailed scenes
nes8-bitNES (54)8pxTrue NES look
gameboyDMG handheld4 green shades8pxMonochrome Game Boy
gameboy_pocketPocket handheld4 grey shades8pxMono GB Pocket
pico8PICO-816 fixed6pxFantasy-console look
c64Commodore 6416 fixed8px8-bit home computer
apple2Apple II hi-res6 fixed10pxExtreme retro, 6 colors
teletextBBC Teletext8 pure10pxChunky primary colors
mspaintWindows MS Paint24 fixed8pxNostalgic desktop
mono_greenCRT phosphor2 green6pxTerminal/CRT aesthetic
mono_amberCRT amber2 amber6pxAmber monitor look
neonCyberpunk10 neons6pxVaporwave/cyber
pastelSoft pastel10 pastels6pxKawaii / gentle

Named palettes live in scripts/palettes.py (see references/palettes.md for the complete list — 28 named palettes total). Any preset can be overridden:

python
pixel_art("in.png", "out.png", preset="snes", palette="PICO_8", block=6)

Scene Catalog (for video)

SceneEffects
nightTwinkling stars + fireflies + drifting leaves
duskFireflies + sparkles
tavernDust motes + warm sparkles
indoorDust motes
urbanRain + neon pulse
natureLeaves + fireflies
magicSparkles + fireflies
stormRain + lightning
underwaterBubbles + light sparkles
fireEmbers + sparkles
snowSnowflakes + sparkles
desertHeat shimmer + dust
Show full SKILL.md (287 more words)Show less

Invocation Patterns

Python (import)
python
import sys
sys.path.insert(0, "/home/teknium/.mateclaw/skills/creative/pixel-art/scripts")
from pixel_art import pixel_art
from pixel_art_video import pixel_art_video

# 1. Convert to pixel art
pixel_art("/path/to/photo.jpg", "/tmp/pixel.png", preset="nes")

# 2. Animate (optional)
pixel_art_video(
    "/tmp/pixel.png",
    "/tmp/pixel.mp4",
    scene="night",
    duration=6,
    fps=15,
    seed=42,
    export_gif=True,
)
CLI
bash
cd /home/teknium/.mateclaw/skills/creative/pixel-art/scripts

python pixel_art.py in.jpg out.png --preset gameboy
python pixel_art.py in.jpg out.png --preset snes --palette PICO_8 --block 6

python pixel_art_video.py out.png out.mp4 --scene night --duration 6 --gif

Pipeline Rationale

Pixel conversion:

  1. Boost contrast/color/sharpness (stronger for smaller palettes)
  2. Posterize to simplify tonal regions before quantization
  3. Downscale by block with Image.NEAREST (hard pixels, no interpolation)
  4. Quantize with Floyd-Steinberg dithering — against either an adaptive N-color palette OR a named hardware palette
  5. Upscale back with Image.NEAREST

Quantizing AFTER downscale keeps dithering aligned with the final pixel grid. Quantizing before would waste error-diffusion on detail that disappears.

Video overlay:

  • Copies the base frame each tick (static background)
  • Overlays stateless-per-frame particle draws (one function per effect)
  • Encodes via ffmpeg libx264 -pix_fmt yuv420p -crf 18
  • Optional GIF via palettegen + paletteuse

Dependencies

  • Python 3.9+
  • Pillow (pip install Pillow)
  • ffmpeg on PATH (only needed for video — the agent installs package this)

Pitfalls

  • Pallet keys are case-sensitive ("NES", "PICO_8", "GAMEBOY_ORIGINAL").
  • Very small sources (<100px wide) collapse under 8-10px blocks. Upscale the source first if it's tiny.
  • Fractional block or palette will break quantization — keep them positive ints.
  • Animation particle counts are tuned for ~640x480 canvases. On very large images you may want a second pass with a different seed for density.
  • mono_green / mono_amber force color=0.0 (desaturate). If you override and keep chroma, the 2-color palette can produce stripes on smooth regions.
  • clarify loop: call it at most twice per turn (style, then scene). Don't pepper the user with more picks.

Verification

  • PNG is created at the output path
  • Clear square pixel blocks visible at the preset's block size
  • Color count matches preset (eyeball the image or run Image.open(p).getcolors())
  • Video is a valid MP4 (ffprobe can open it) with non-zero size

Attribution

Named hardware palettes and the procedural animation loops in pixel_art_video.py are ported from pixel-art-studio (MIT). See ATTRIBUTION.md in this skill directory for details.

© mateaix, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in mateclaw-server/src/main/resources/skills/pixel-art of mateaix/mateclaw.

  • SKILL.md
  • ATTRIBUTION.md
  • references/palettes.md
  • scripts/__init__.py
  • scripts/palettes.py
  • scripts/pixel_art.py
  • scripts/pixel_art_video.py

Open the folder on GitHubat commit 3b5f7de

Used in 5 other repositories

We found 6 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in mateaix/mateclaw, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Pixel Art next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pixel Art compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pixel Art this skillmateaix/mateclaw1.1k5 repos~1.8kAutomated safety check: PassApache-2.0
Game Asset Generatorhtdt/godogen7.1k—~2.8kAutomated safety check: PassMIT
Code-Drawn 2D Game Art0x0funky/agent-sprite-forge4.3k—~2.5kAutomated safety check: PassMIT
Sprite Genaldegad/sprite-gen2.6k—~4.4kAutomated safety check: PassApache-2.0
Asset Pipelinerehan-remade/universal-modder4.7k—~2kAutomated safety check: PassMIT
Petdexcrafter-station/petdex4.2k—~614Automated safety check: PassMIT

Similar skills

  • Generates game art from text prompts: PNG images, GLB 3D models, rigged characters, animations and sprites, with background removal.

    7.1k GitHub stars~2.8k tokensUpdated 5 days ago
    Game DevelopmentAuto-check passed
  • Code-Drawn 2D Game Art

    0x0funky/agent-sprite-forge

    Draws 2D game art from code with no image model: pixel sprites, SVG props and icons, rigged characters, FX, autotiles and layouts, only when explicitly asked for.

    4.3k GitHub stars~2.5k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Sprite Gen

    aldegad/sprite-gen

    Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation.

    2.6k GitHub stars~4.4k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Asset Pipeline

    rehan-remade/universal-modder

    Turn generated or hand-made art into exactly what a game engine loads.

    4.7k GitHub stars~2k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Petdex

    crafter-station/petdex

    Browse, install, submit, and edit pixel-art pets with the Petdex CLI.

    4.2k GitHub stars~614 tokensUpdated 8 days ago
    Game DevelopmentAuto-check passed
  • Hatch Pet

    hAcKlyc/MyAgents

    Create, repair, validate, visually QA, and package MyAgents/Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual…

    915 GitHub starsUsed in 1 repo~9.5k tokens
    Game DevelopmentAuto-check passed

More from mateaix/mateclaw

All 17 skills in this repo
  • DOCX

    mateaix/mateclaw

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    1.1k GitHub stars~4.1k tokensUpdated 2 days ago
    Auto-check passed
  • XLSX

    mateaix/mateclaw

    Use this skill any time a spreadsheet file is the primary input or output.

    1.1k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Execute plans via delegatetask subagents (2-stage review). An agent skill from mateaix/mateclaw.

    1.1k GitHub starsUsed in 3 repos~2.6k tokens
    Auto-check passed
  • Ideation

    mateaix/mateclaw

    Generate project ideas via creative constraints. An agent skill from mateaix/mateclaw.

    1.1k GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Architecture Diagram

    mateaix/mateclaw

    Dark-themed SVG architecture/cloud/infra diagrams as HTML. An agent skill from mateaix/mateclaw.

    1.1k GitHub starsUsed in 5 repos~1.7k tokens
    Auto-check passed
  • Officecli

    mateaix/mateclaw

    Use the optional iOfficeAI/OfficeCLI engine for advanced inspection, validation, copy-on-write editing, template merge, or visual rendering of existing .docx, .xlsx, and .pptx files.

    1.1k GitHub stars~844 tokensUpdated 2 days ago
    Auto-check passed

Questions about Pixel Art

What does Pixel Art do?

Pixel art w/ era palettes (NES, Game Boy, PICO-8). An agent skill from mateaix/mateclaw. Pixel Art is an agent skill from mateaix/mateclaw. Pixel art w/ era palettes (NES, Game Boy, PICO-8).

When should I use Pixel Art?

Pixel Art fits situations like: tasks that involve Sprites and pixel art.

How do I install Pixel Art in Claude Code?

Run `npx skills add mateaix/mateclaw --skill pixel-art -a claude-code`. Or copy the skill folder (mateclaw-server/src/main/resources/skills/pixel-art in mateaix/mateclaw) into .claude/skills/pixel-art in your project. Claude Code loads it when a task matches its description.

How do I install Pixel Art in Codex?

Run `npx skills add mateaix/mateclaw --skill pixel-art -a codex`. Or copy the skill folder (mateclaw-server/src/main/resources/skills/pixel-art in mateaix/mateclaw) into .agents/skills/pixel-art in your project. Codex loads it when a task matches its description.

Can I use Pixel Art in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mateaix/mateclaw --skill pixel-art -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pixel-art, .gemini/skills/pixel-art, .github/skills/pixel-art and .opencode/skills/pixel-art in your project.

What does Pixel Art need to run?

Going by SKILL.md and its folder, Pixel Art needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Pixel Art access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Pixel Art safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Pixel Art use?

Pixel Art is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pixel Art use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 428 tokens, read only when the agent opens those files.

What are the alternatives to Pixel Art?

Skills that share tags, products or a category with Pixel Art: Game Asset Generator (htdt/godogen, 7.1k stars), Code-Drawn 2D Game Art (0x0funky/agent-sprite-forge, 4.3k stars), Sprite Gen (aldegad/sprite-gen, 2.6k stars) and Asset Pipeline (rehan-remade/universal-modder, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pixel Art?

mateaix (a GitHub user) maintains it in mateaix/mateclaw, which has 1,147 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 5, 2026.

Source: mateaix/mateclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.