Initial commit

commands/pixel-new.md

@@ -0,0 +1,190 @@
+---
+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!
+```