Pixel Art Snap

Convert upscaled/blurry pixel art images back to clean, sharp pixel art.

Script Location

The script is at: ${CLAUDE_SKILL_DIR}/pixel-art-snap.js

It requires the sharp npm package. If not installed, run:

cd ${CLAUDE_SKILL_DIR} && npm install sharp

Usage

Run the script with:

node ${CLAUDE_SKILL_DIR}/pixel-art-snap.js [input] [output] [options]

Arguments from user

The user's arguments: $ARGUMENTS

Options

--mode=auto|icon|scene — Post-processing mode (default: auto-detect)
- icon: remove white background, crop, center on square, scale
- scene: keep full image, scale with nearest-neighbor
--size=1024 — Target output size in pixels (default: 1024)
--grid=N — Force grid size in pixels (skip auto-detection)
--threshold=240 — White background threshold (default: 240)

Workflow

Parse the user's arguments to determine input file and options
If no input file is specified, ask the user for one
Run the script with the appropriate arguments
Report the results (grid size detected, mode used, output path)
If the user wants to preview the result, read the output image file

Examples

# Basic usage
node ${CLAUDE_SKILL_DIR}/pixel-art-snap.js ~/images/sprite.png

# Specify output and size
node ${CLAUDE_SKILL_DIR}/pixel-art-snap.js input.png output.png --size=512

# Force icon mode with custom grid
node ${CLAUDE_SKILL_DIR}/pixel-art-snap.js sprite.png --mode=icon --grid=16

pixel-snap