140 lines
3.1 KiB
Markdown
140 lines
3.1 KiB
Markdown
# Commands
|
|
|
|
This directory contains slash commands that users invoke directly in Claude Code.
|
|
|
|
## Available Commands
|
|
|
|
### /pixel-new
|
|
Create a new pixel art sprite with optional size and palette presets.
|
|
|
|
**Usage:** `/pixel-new [size] [palette]`
|
|
|
|
**Size presets:**
|
|
- `icon` - 32x32
|
|
- `small` - 48x48
|
|
- `medium` - 64x64 (default)
|
|
- `large` - 128x128
|
|
- `tile` - 16x16
|
|
- `gameboy` - 160x144
|
|
- `nes` - 256x240
|
|
|
|
**Palette presets:**
|
|
- `retro` - 16-color generic palette
|
|
- `nes` - 54-color NES palette
|
|
- `gameboy` - 4-color Game Boy palette
|
|
- `c64` - 16-color Commodore 64 palette
|
|
- `cga` - 4-color CGA palette
|
|
- `snes` - 256-color SNES palette
|
|
|
|
**Examples:**
|
|
```
|
|
/pixel-new
|
|
/pixel-new icon
|
|
/pixel-new 128x128 nes
|
|
/pixel-new gameboy gameboy
|
|
```
|
|
|
|
### /pixel-palette
|
|
Manage sprite color palettes.
|
|
|
|
**Usage:** `/pixel-palette <action> [args]`
|
|
|
|
**Actions:**
|
|
- `set <preset>` - Apply a preset palette
|
|
- `optimize <colors>` - Reduce palette to N colors
|
|
- `show` - Display current palette
|
|
- `export <file>` - Save palette to file
|
|
|
|
**Examples:**
|
|
```
|
|
/pixel-palette set nes
|
|
/pixel-palette optimize 16
|
|
/pixel-palette show
|
|
/pixel-palette export my-palette.pal
|
|
```
|
|
|
|
### /pixel-export
|
|
Export sprite to various formats.
|
|
|
|
**Usage:** `/pixel-export <format> [file] [options]`
|
|
|
|
**Formats:**
|
|
- `png` - Single frame PNG
|
|
- `gif` - Animated GIF
|
|
- `sheet` - Spritesheet
|
|
- `json` - Metadata file
|
|
|
|
**Options:**
|
|
- `scale=N` - Pixel-perfect scaling (1, 2, 4, 8)
|
|
- `fps=N` - Frame rate for GIF
|
|
- `layout=type` - Spritesheet layout (horizontal, vertical, grid, packed)
|
|
- `format=type` - JSON format (aseprite, unity, godot, phaser)
|
|
|
|
**Examples:**
|
|
```
|
|
/pixel-export png sprite.png
|
|
/pixel-export gif animation.gif fps=12
|
|
/pixel-export sheet characters.png layout=grid
|
|
/pixel-export png icon.png scale=4
|
|
```
|
|
|
|
### /pixel-setup
|
|
Configure the Aseprite MCP server.
|
|
|
|
**Usage:** `/pixel-setup [path]`
|
|
|
|
Auto-detects Aseprite installation or accepts manual path.
|
|
|
|
**Platform paths:**
|
|
- macOS: `/Applications/Aseprite.app/Contents/MacOS/aseprite`
|
|
- Linux: `/usr/bin/aseprite`
|
|
- Windows: `C:\Program Files\Aseprite\Aseprite.exe`
|
|
|
|
**Examples:**
|
|
```
|
|
/pixel-setup
|
|
/pixel-setup /usr/local/bin/aseprite
|
|
```
|
|
|
|
### /pixel-help
|
|
Display help information.
|
|
|
|
**Usage:** `/pixel-help [topic]`
|
|
|
|
**Topics:**
|
|
- `palettes` - Available color palettes
|
|
- `export` - Export formats and options
|
|
- `animation` - Animation features
|
|
- `shortcuts` - Common workflows
|
|
|
|
**Examples:**
|
|
```
|
|
/pixel-help
|
|
/pixel-help palettes
|
|
/pixel-help export
|
|
```
|
|
|
|
## Command Structure
|
|
|
|
Each command is a markdown file with YAML frontmatter:
|
|
|
|
```yaml
|
|
---
|
|
description: Brief description shown in /help
|
|
argument-hint: [arg1] [arg2]
|
|
allowed-tools: Tool1, Tool2, mcp__aseprite__*
|
|
---
|
|
```
|
|
|
|
Commands use `$ARGUMENTS` to access user input and can execute MCP tools to interact with Aseprite.
|
|
|
|
## MCP Tools Used
|
|
|
|
Commands use these pixel-mcp tools:
|
|
- `mcp__aseprite__create_canvas` - Create new sprites
|
|
- `mcp__aseprite__set_palette` - Set color palettes
|
|
- `mcp__aseprite__export_sprite` - Export to files
|
|
- `mcp__aseprite__get_sprite_info` - Query sprite properties
|
|
|
|
See the pixel-mcp documentation for the full list of available tools.
|