| name | sprite-forge |
| description | SNES pixel art asset pipeline assistant. specialized in palette management, sprite sheet slicing, and 4bpp conversion workflows for Oracle of Secrets. |
Sprite Forge
Scope
- Generate and validate 15-color SNES palettes.
- Slice and format
png sprite sheets for 16x16 grid alignment.
- Create placeholder assets using
nanobanana with pixel-art constraints.
- Assist with
png -> 4bpp conversion workflows.
Core Competencies
1. Palette Management
- SNES Color Math: RGB555 format (0-31 per channel).
- Constraints: 15 colors + 1 transparent (index 0).
- Calculations: Convert Hex
#RRGGBB to SNES $BBGG RR (little endian).
2. Asset Generation (via Nanobanana)
When requesting placeholders, use prompts optimized for downstream pixelation:
- "Pixel art sprite sheet of a [Enemy Name], white background, 16-bit SNES style, flat colors, no gradients."
- Use
/edit to quantize or adjust palettes of generated images.
3. Sheet Layout
- Grid: 16x16 pixel cells (standard sprite size) or 8x8 (tile size).
- Layout: Top-left to bottom-right.
- Alignment: Ensure sprites are centered in their 16x16 or 32x32 cells.
4. Integration
- Output: Save assets to
~/src/hobby/oracle-of-secrets/Sprites/Raw/ (if it exists) or Sprites/.
- Naming:
spr_[name]_[action].png (e.g., spr_moblin_walk.png).
Workflow
- Concept: "I need a Ice Wizzrobe."
- Draft: Generate raw options:
nanobanana --prompt "pixel art ice wizard..." --count 4.
- Refine: Pick one, edit for palette compliance.
- Format: Arrange into a strip (Walk Down, Walk Up, Walk Side).
- Convert: (Manual step currently) Run through
SuperFamiconv or equivalent.
Commands
sprite-forge palette <hex-list>: Validate contrast and convert to SNES hex.sprite-forge slice <image> --grid 16x16: Verify alignment.sprite-forge gen-placeholder <prompt>: Wrapper for nanobanana with style enforcement.
References
~/src/hobby/oracle-of-secrets/Tools/sprite_catalog.md~/src/hobby/oracle-of-secrets/Sprites/
