gh-willibrandon-pixel-plugin/commands/pixel-new.md

description: Create a new pixel art sprite with optional size and palette presets argument-hint: [size] [palette] allowed-tools: Read, Bash, mcp__aseprite__create_canvas, mcp__aseprite__set_palette

/pixel-new - Quick Sprite Creation

Creates a new pixel art sprite with optional presets for size and palette.

Usage

/pixel-new [size] [palette]

Arguments

size (optional): Canvas dimensions or preset name

• Presets: icon, small, medium, large, tile, gameboy, nes
• Custom: WIDTHxHEIGHT (e.g., 64x64, 128x96)
• Default: 64x64

palette (optional): Color palette preset

• retro, nes, gameboy, c64, cga, snes, custom
• Default: RGB (no palette limit)

Examples

/pixel-new
→ Creates 64x64 RGB canvas

/pixel-new icon
→ Creates 32x32 RGB canvas

/pixel-new gameboy gameboy
→ Creates 160x144 canvas with Game Boy 4-color palette

/pixel-new 128x128 nes
→ Creates 128x128 canvas with NES palette

/pixel-new tile retro
→ Creates 16x16 canvas with retro 16-color palette

Size Presets

• icon: 32x32 (for icons, small sprites)
• small: 48x48 (characters, items)
• medium: 64x64 (default, versatile)
• large: 128x128 (detailed sprites, portraits)
• tile: 16x16 (tilemap tiles)
• gameboy: 160x144 (Game Boy screen resolution)
• nes: 256x240 (NES screen resolution)

Palette Presets

• retro: 16-color palette (generic retro aesthetic)
• nes: 54-color NES palette
• gameboy: 4-color Game Boy palette (#0f380f, #306230, #8bac0f, #9bbc0f)
• c64: 16-color Commodore 64 palette
• cga: 4-color CGA palette
• snes: 256-color SNES-style palette
• custom: Prompts for custom palette colors

Implementation

Parse arguments from $ARGUMENTS:

1. Extract size argument (first arg)
2. Extract palette argument (second arg)
3. Map size preset to dimensions or parse WxH
4. Create canvas with mcp__aseprite__create_canvas
5. If palette specified, set palette with mcp__aseprite__set_palette
6. Confirm creation with sprite info

Size Preset Mapping

icon     → 32x32
small    → 48x48
medium   → 64x64
large    → 128x128
tile     → 16x16
gameboy  → 160x144
nes      → 256x240

Palette Details

retro (16 colors):

• Generic retro palette with balanced colors
• Good for general pixel art without console constraints

nes (54 colors):

• Official NES/Famicom palette
• Use indexed color mode
• Typically limit to 4 colors per sprite for authenticity

gameboy (4 colors):

• #0f380f (darkest green)
• #306230 (dark green)
• #8bac0f (light green)
• #9bbc0f (lightest green)

c64 (16 colors):

• Commodore 64 fixed palette
• Distinctive colors with high saturation

cga (4 colors):

• Classic IBM CGA palette
• High contrast, limited colors

snes (256 colors):

• SNES-style palette with rich colors
• Supports smooth gradients and detailed sprites

custom:

• Prompts user for custom colors
• Ask for number of colors and hex values

Validation

Size validation:

• If preset name, map to dimensions
• If WxH format, parse width and height
• Ensure dimensions are 1-65535
• Reject invalid formats

Palette validation:

• Check if preset exists
• For custom, validate hex color format
• Ensure palette is appropriate for sprite size

Error Handling

Invalid size:

• "Invalid size format. Use a preset (icon, small, medium, large, tile, gameboy, nes) or WIDTHxHEIGHT (e.g., 64x64)"

Invalid palette:

• "Invalid palette. Choose from: retro, nes, gameboy, c64, cga, snes, custom"

Dimensions out of range:

• "Dimensions must be between 1 and 65535 pixels"

Canvas creation fails:

• Report MCP error and suggest checking Aseprite configuration

Notes

• If no arguments, create default 64x64 RGB canvas
• For retro palettes, use Indexed color mode
• For RGB mode, no palette needed
• Validate dimensions (1-65535)
• Provide helpful error messages for invalid input
• After creation, confirm canvas size and palette
• Use mcp__aseprite__get_sprite_info to verify creation

Command Flow

1. Parse $ARGUMENTS into size and palette
2. If no size, use default (64x64)
3. Map size preset to dimensions or parse WxH
4. Validate dimensions
5. Call mcp__aseprite__create_canvas with dimensions
6. If palette specified:
   • Map palette preset to color list
   • Call mcp__aseprite__set_palette with colors
7. Get sprite info to confirm
8. Report success with canvas details

Example Outputs

Success with default:

Created 64x64 RGB canvas.
Ready for pixel art creation!

Success with presets:

Created 160x144 canvas with Game Boy palette (4 colors).
Perfect for Game Boy-style sprites!

Success with custom size and palette:

Created 128x128 canvas with NES palette (54 colors).
Canvas ready with retro NES colors!