Agent skill

Pixel Art Scaler

by curiositech in curiositech/some_claude_skills

Deterministic pixel art upscaling using EPX/Scale2x, hq2x/hq4x, and xBR algorithms that add valid sub-pixels through pattern recognition.

MITAuto-check passedGame Development

Install Pixel Art Scaler

skills CLI
$ npx skills add curiositech/some_claude_skills --skill pixel-art-scaler -a claude-code

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

GitHub CLI
$ gh skill install curiositech/some_claude_skills pixel-art-scaler --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/curiositech/some_claude_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/pixel-art-scaler .claude/skills/pixel-art-scaler && 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-scaler
GitHub stars
244
Token cost
~2.4k tokens
SKILL.md length
895 words
Files
5 (incl. scripts)
Skills in repo
95
Repo updated
First seen
Licence
MIT

At a glance

Deterministic pixel art upscaling using EPX/Scale2x, hq2x/hq4x, and xBR algorithms that add valid sub-pixels through pattern recognition.

  • Works in 3 steps: EPX/Scale2x (Fastest, Good Quality) → hq2x/hq3x/hq4x (High Quality, Slower) → xBR/Super-xBR (Highest Quality, Slowest)
  • Tasks that involve Sprites and pixel art
  • SKILL.md covers When to Use, Core Algorithms, Anti-Patterns and Usage, plus 5 more sections
  • Runs Python scripts from its folder; calls python3 and pip

What it does

Pixel Art Scaler is an agent skill from curiositech/some_claude_skills. Deterministic pixel art upscaling using EPX/Scale2x, hq2x/hq4x, and xBR algorithms that add valid sub-pixels through pattern recognition. Activate on 'pixel art scaling', 'EPX', 'Scale2x', 'hq2x', 'hq4x', 'xBR', 'retro game upscaling'. NOT for AI/ML upscaling, photo enlargement, or simple nearest-neighbor.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `.claude-plugin/plugin.json`, `scripts/batch_scale.py` and `scripts/compare_algorithms.py`).

It sits in Game Development, covering Sprites and pixel art. The repository describes itself as: Claude skills that make my life easier. The licence is MIT.

When your agent uses it

  • Tasks that involve Sprites and pixel art

Example prompts

  • “pixel art scaling”
  • “Scale2x”
  • “retro game upscaling”
  • “/pixel-art-scaler”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Bash(python3:*,pip:*)

Workflow steps

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

  1. EPX/Scale2x (Fastest, Good Quality)
  2. hq2x/hq3x/hq4x (High Quality, Slower)
  3. xBR/Super-xBR (Highest Quality, Slowest)

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash(python3:*
    • pip:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

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

    Shell commands in SKILL.md call:

    • python3
    • 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):

    • en.wikipedia.org
    • scale2x.it
    • every-algorithm.github.io
    • 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 Scaler loads about 2.4k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 895 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

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 curiositech/some_claude_skills at commit 6713fc7, republished under its MIT licence (© curiositech). 895 words, ~2,423 tokens.

Download SKILL.mdSave it as .claude/skills/pixel-art-scaler/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
pixel-art-scaler
description
Deterministic pixel art upscaling using EPX/Scale2x, hq2x/hq4x, and xBR algorithms that add valid sub-pixels through pattern recognition. Activate on 'pixel art scaling', 'EPX', 'Scale2x', 'hq2x', 'hq4x', 'xBR', 'retro game upscaling'. NOT for AI/ML upscaling, photo enlargement, or simple nearest-neighbor.
allowed-tools
Read, Write, Bash(python3:*,pip:*)
metadata.category
Design & Creative
metadata.tags
pixel, art, scaler

Pixel Art Scaler

Deterministic algorithms for upscaling pixel art that preserve aesthetics by adding valid sub-pixels through edge detection and pattern matching.

When to Use

✅ Use for:

  • Upscaling retro game sprites, icons, and pixel art
  • 2x, 3x, 4x scaling with edge-aware interpolation
  • Preserving sharp pixel art aesthetic at higher resolutions
  • Converting 8x8, 16x16, 32x32, 48x48 pixel art for retina displays
  • Comparing deterministic vs AI/ML approaches

❌ NOT for:

  • Photographs or realistic images (use AI super-resolution)
  • Simple geometric scaling (use nearest-neighbor)
  • Vector art (use SVG)
  • Text rendering (use font hinting)
  • Arbitrary non-integer scaling (algorithms work best at 2x, 3x, 4x)

Core Algorithms

1. EPX/Scale2x (Fastest, Good Quality)

Best for: Quick iteration, 2x/3x scaling, transparent sprites

How it works:

  • Examines each pixel and its 4 cardinal neighbors (N, S, E, W)
  • Expands 1 pixel → 4 pixels (2x) or 9 pixels (3x) using edge detection
  • Only uses colors from original palette (no new colors)
  • Handles transparency correctly

When to use:

  • Need fast processing (100+ icons)
  • Want crisp edges with no anti-aliasing
  • Source has clean pixel boundaries
  • Transparency preservation is critical

Timeline: Invented by Eric Johnston at LucasArts (~1992), rediscovered by Andrea Mazzoleni (2001)

2. hq2x/hq3x/hq4x (High Quality, Slower)

Best for: Final renders, complex sprites, smooth gradients

How it works:

  • Pattern matching on 3x3 neighborhoods (256 possible patterns)
  • YUV color space thresholds for edge detection
  • Sophisticated interpolation rules per pattern
  • Produces smooth, anti-aliased edges

When to use:

  • Final production assets
  • Source has gradients or dithering
  • Want smooth, anti-aliased results
  • Processing time is acceptable (~5-10x slower than EPX)

Timeline: Developed by Maxim Stepin for emulators (2003)

3. xBR/Super-xBR (Highest Quality, Slowest)

Best for: Hero assets, promotional materials, detailed sprites

How it works:

  • Advanced edge detection with weighted blending
  • Multiple passes for smoother results (Super-xBR)
  • Preserves fine details while smoothing edges
  • Best anti-aliasing of the three algorithms

When to use:

  • Maximum quality needed
  • Complex sprites with fine details
  • Marketing/promotional use
  • Time is not a constraint (~20x slower than EPX)

Timeline: xBR by Hyllian (2011), Super-xBR (2015)

Anti-Patterns

Anti-Pattern: Nearest-Neighbor for Display

Novice thinking: "Just use nearest-neighbor 4x, it preserves pixels"

Reality: Nearest-neighbor creates blocky repetition without adding detail. Each pixel becomes NxN identical blocks, which looks crude on high-DPI displays.

What deterministic algorithms do: Add valid sub-pixels through pattern recognition - a diagonal edge gets anti-aliased pixels, straight edges stay crisp.

Timeline:

  • Pre-2000s: Nearest-neighbor was only option
  • 2001+: EPX/Scale2x enabled smart 2x scaling
  • 2003+: hq2x added sophisticated pattern matching
  • 2011+: xBR became state-of-the-art

When nearest-neighbor IS correct: Viewing pixel art at exact integer multiples in pixel-perfect contexts (e.g., 1:1 reference images).

Anti-Pattern: Using AI/ML for Pixel Art

Novice thinking: "Real-ESRGAN / Waifu2x will give better results"

Reality: AI models trained on photos/anime add inappropriate detail to pixel art. They invent textures and smooth edges that shouldn't exist, destroying the intentional pixel-level decisions.

LLM mistake: Training data includes "upscaling = use AI models" advice from photo editing contexts.

Correct approach:

Source TypeAlgorithm
Pixel art (sprites, icons)EPX/hq2x/xBR (this skill)
Pixel art photos (screenshots)Hybrid: xBR first, then light AI
Photos/realistic artAI super-resolution
Mixed contentTest both, compare results
Show full SKILL.md (386 more words)Show less
Anti-Pattern: Wrong Algorithm for Context

Novice thinking: "Always use the highest quality algorithm"

Reality: Different algorithms serve different purposes:

ContextAlgorithmWhy
Iteration/prototypingEPX10x faster, good enough
Production assets (web)hq2xBalance of quality/size
Hero images (marketing)xBRMaximum quality
Transparent spritesEPXBest transparency handling
Complex gradientshq4xBest gradient interpolation

Validation: Always compare outputs visually - sometimes EPX 2x looks better than hq4x!

Usage

Quick Start
bash
# Install dependencies
cd ~/.claude/skills/pixel-art-scaler/scripts
pip install Pillow numpy

# Scale a single icon with EPX 2x (fastest)
python3 scale_epx.py input.png output.png --scale 2

# Scale with hq2x (high quality)
python3 scale_hqx.py input.png output.png --scale 2

# Scale with xBR (maximum quality)
python3 scale_xbr.py input.png output.png --scale 2

# Batch process directory
python3 batch_scale.py input_dir/ output_dir/ --algorithm epx --scale 2

# Compare all algorithms side-by-side
python3 compare_algorithms.py input.png output_comparison.html
Algorithm Selection Guide

Decision tree:

Need to scale pixel art?
├── Transparency important? → EPX
├── Fast iteration needed? → EPX
├── Complex gradients/dithering? → hq2x or hq4x
├── Maximum quality for hero asset? → xBR
└── Not sure? → Run compare_algorithms.py
Typical Workflow
  1. Prototype with EPX 2x: Process all assets quickly
  2. Review results: Identify which need higher quality
  3. Re-process heroes with hq4x or xBR: Apply to key assets only
  4. Compare outputs: Use compare_algorithms.py for side-by-side
  5. Optimize: Sometimes 2x looks better than 4x (test both)

Scripts Reference

All scripts in scripts/ directory:

ScriptPurposeSpeedQuality
scale_epx.pyEPX/Scale2x implementationFastGood
scale_hqx.pyhq2x/hq3x/hq4x implementationMediumGreat
scale_xbr.pyxBR/Super-xBR implementationSlowBest
batch_scale.pyProcess directoriesVariesVaries
compare_algorithms.pyGenerate comparison HTMLN/AN/A

Each script includes:

  • CLI interface with --help
  • Transparency preservation
  • Error handling for corrupted inputs
  • Progress indicators for batch operations

Technical Details

Color Space Considerations

EPX: Works in RGB, binary edge detection hq2x/hq4x: Uses YUV color space with thresholds (Y=48, Cb=7, Cr=6) xBR: Advanced edge weighting in RGB with luminance consideration

Transparency Handling

All algorithms preserve alpha channel:

  • Transparent pixels don't influence edge detection
  • Semi-transparent pixels are handled correctly
  • Output maintains RGBA format if input has alpha
Performance Benchmarks (M4 Max, 48x48 input)
AlgorithmTime (1 image)Batch (100 images)
EPX 2x0.01s1s
EPX 3x0.02s2s
hq2x0.10s10s
hq4x0.30s30s
xBR 2x0.15s15s
xBR 4x0.50s50s

Rule of thumb: EPX is ~10x faster than hq2x, ~20x faster than xBR

Output Validation

After scaling, verify results:

bash
# Check output dimensions
identify output.png  # Should be exactly 2x, 3x, or 4x input

# Visual inspection
open output.png  # Look for artifacts, incorrect edges

# Compare algorithms
python3 compare_algorithms.py input.png comparison.html
open comparison.html  # Side-by-side comparison

Common issues:

  • Jagged diagonals → Try hq2x or xBR instead of EPX
  • Blurry edges → Check if input was already scaled (apply to original)
  • Wrong colors → Verify input is RGB/RGBA (not indexed/paletted PNG)

References

Deep Dives
  • /references/algorithm-comparison.md - Visual examples and trade-offs
  • /references/epx-algorithm.md - EPX/Scale2x implementation details
  • /references/hqx-patterns.md - hq2x pattern matching table explanation
  • /references/xbr-edge-detection.md - xBR edge weighting formulas
Research Papers & Sources
Example Assets
  • /assets/test-sprites/ - Sample sprites for testing algorithms
  • /assets/expected-outputs/ - Reference outputs for validation

Changelog

  • 2026-02-05: Initial skill creation with EPX, hq2x, xBR implementations

© curiositech, MIT. 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 4 other files (scripts) in .claude/skills/pixel-art-scaler of curiositech/some_claude_skills.

  • SKILL.md
  • .claude-plugin/plugin.json
  • scripts/batch_scale.py
  • scripts/compare_algorithms.py
  • scripts/scale_epx.py

Open the folder on GitHubat commit 6713fc7

Compare with similar skills

Pixel Art Scaler 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 Scaler compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pixel Art Scaler this skillcuriositech/some_claude_skills244—~2.4kAutomated safety check: PassMIT
Game Asset Generatorhtdt/godogen7.1k—~2.8kAutomated safety check: PassMIT
Code-Drawn 2D Game Art0x0funky/agent-sprite-forge4.4k—~2.5kAutomated safety check: PassMIT
Sprite Genaldegad/sprite-gen2.7k—~4.9kAutomated safety check: PassApache-2.0
Pixel Artmateaix/mateclaw1.2k5 repos~1.8kAutomated safety check: PassApache-2.0
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 9 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.4k GitHub stars~2.5k tokensUpdated 4 days ago
    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.7k GitHub stars~4.9k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Pixel Art

    mateaix/mateclaw

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

    1.2k GitHub starsUsed in 5 repos~1.8k tokens
    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 today
    Game DevelopmentAuto-check passed
  • Asset Pipeline

    rehan-remade/universal-modder

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

    6.1k GitHub stars~2k tokensUpdated today
    Game DevelopmentAuto-check passed

More from curiositech/some_claude_skills

All 95 skills in this repo
  • Crisis Detection Intervention AI

    curiositech/some_claude_skills

    Detect crisis signals in user content using NLP, mental health sentiment analysis, and safe intervention protocols.

    244 GitHub starsUsed in 2 repos~3.8k tokens
    Auto-check passed
  • Form Validation Architect

    curiositech/some_claude_skills

    End-to-end form handling with react-hook-form, Zod schemas, validation patterns, error messaging, field arrays, and multi-step wizards.

    244 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • GitHub Actions Pipeline Builder

    curiositech/some_claude_skills

    Build production CI/CD pipelines with GitHub Actions. An agent skill from curiositech/some_claude_skills.

    244 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check: notes
  • Background Job Orchestrator

    curiositech/some_claude_skills

    Expert in background job processing with Bull/BullMQ (Redis), Celery, and cloud queues.

    244 GitHub stars~3.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Competitive Cartographer

    curiositech/some_claude_skills

    Strategic analyst that maps competitive landscapes, identifies white space opportunities, and provides positioning recommendations.

    244 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Computer Vision Pipeline

    curiositech/some_claude_skills

    Build production computer vision pipelines for object detection, tracking, and video analysis.

    244 GitHub stars~4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Pixel Art Scaler

What does Pixel Art Scaler do?

Deterministic pixel art upscaling using EPX/Scale2x, hq2x/hq4x, and xBR algorithms that add valid sub-pixels through pattern recognition. Pixel Art Scaler is an agent skill from curiositech/some_claude_skills. Deterministic pixel art upscaling using EPX/Scale2x, hq2x/hq4x, and xBR algorithms that add valid sub-pixels through pattern recognition.

When should I use Pixel Art Scaler?

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

How do I install Pixel Art Scaler in Claude Code?

Run `npx skills add curiositech/some_claude_skills --skill pixel-art-scaler -a claude-code`. Or copy the skill folder (.claude/skills/pixel-art-scaler in curiositech/some_claude_skills) into .claude/skills/pixel-art-scaler in your project. Claude Code loads it when a task matches its description.

How do I install Pixel Art Scaler in Codex?

Run `npx skills add curiositech/some_claude_skills --skill pixel-art-scaler -a codex`. Or copy the skill folder (.claude/skills/pixel-art-scaler in curiositech/some_claude_skills) into .agents/skills/pixel-art-scaler in your project. Codex loads it when a task matches its description.

Can I use Pixel Art Scaler 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 curiositech/some_claude_skills --skill pixel-art-scaler -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-scaler, .gemini/skills/pixel-art-scaler, .github/skills/pixel-art-scaler and .opencode/skills/pixel-art-scaler in your project.

What does Pixel Art Scaler need to run?

Going by SKILL.md and its folder, Pixel Art Scaler needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and pip). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Bash(python3:*,pip:*).

Does Pixel Art Scaler access the network?

SKILL.md names 4 domains. As links in the text: en.wikipedia.org, scale2x.it, every-algorithm.github.io and github.com. This is read from the text; nothing was executed.

Is Pixel Art Scaler 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 Scaler use?

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

How many tokens does Pixel Art Scaler use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pixel Art Scaler?

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

Who maintains Pixel Art Scaler?

curiositech (a GitHub organization) maintains it in curiositech/some_claude_skills, which has 244 GitHub stars. The repository holds 95 skills in this directory. The repository was last updated on September 6, 2026.

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