Help us improve
Share bugs, ideas, or general feedback.
From pixelforge-mcp
Use when processing, cropping, splitting, or cleaning up existing sprite images or sprite sheets. Triggers on "crop sprite", "remove background", "split sprite sheet", "make transparent", "process PNG".
npx claudepluginhub freema/pixelforge-mcp --plugin pixelforge-mcpHow this skill is triggered — by the user, by Claude, or both
Slash command
/pixelforge-mcp:sprite-processingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use `process_sprite` to clean up existing images into game-ready sprites.
Defines import, slicing, atlas packing, and naming rules for 2D sprites to enforce consistent asset conventions across the project.
Exports pixel art sprites from Aseprite to PNG, GIF, spritesheets, and JSON metadata for game engines like Unity, Godot, Phaser. Supports layouts, scaling, and frame exports.
Generates animated 2D sprite sheets (walk cycles, attack frames, idle, death) and wires them into AnimatedSprite2D/SpriteFrames. Offers per-frame img2img, single-call sheet generation, or manual authoring paths.
Share bugs, ideas, or general feedback.
Use process_sprite to clean up existing images into game-ready sprites.
Remove background and auto-crop:
process_sprite
inputPath: "raw-enemy.png"
outputPath: "public/assets/games/rpg/enemy.png"
background: "chromakey"
square: true
Prefer chromakey background — uses HSV-based green screen removal. Much cleaner than black/white.
Split a horizontal sprite sheet into individual frames:
process_sprite
inputPath: "animation-sheet.png"
outputPath: "public/assets/games/rpg/hero"
split: true
names: ["idle", "walk-1", "walk-2", "attack"]
background: "chromakey"
square: true
Outputs: hero-idle.png, hero-walk-1.png, hero-walk-2.png, hero-attack.png
When sprite sheet has white background but individual sprites have black background:
# 1. Split sheet (removes white bg between sprites)
process_sprite
inputPath: "sheet.png"
outputPath: "public/assets/sprites/char"
split: true
names: ["head", "body", "legs"]
background: "white"
square: true
# 2. Remove black bg from each sprite
process_sprite
inputPath: "public/assets/sprites/char-head.png"
background: "black"
threshold: 8
skipCrop: true
| Background | Method | Best For |
|---|---|---|
chromakey | HSV green screen | BEST — cleanest edges, no artifacts |
black | Compositing equation | Dark-themed sprites |
white | Compositing equation | Light-themed sprites |
auto | Edge detection | Unknown backgrounds |
| Option | Default | Description |
|---|---|---|
background | auto-detect | "chromakey", "black", "white", or "auto" |
threshold | 20 | Color detection sensitivity (0-255) |
square | false | Pad output to square dimensions |
padding | 2 | Pixels of padding around content |
split | false | Split sheet into individual sprites |
names | 0, 1, 2... | Names for split sprites |
skipCrop | false | Keep original dimensions |
skipTransparent | false | Don't remove background |