pixelsrc 0.2.0

Pixelsrc - GenAI-native pixel art format and compiler
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

# prompts

Show GenAI prompt templates for sprite generation.

## Usage

```
pxl prompts [TEMPLATE]
```

## Arguments

| Argument | Description |
|----------|-------------|
| `[TEMPLATE]` | Template name to show. If omitted, lists all available templates |

## Available Templates

| Template | Description |
|----------|-------------|
| `character` | Character sprite generation prompt |
| `item` | Item and object sprite generation |
| `tileset` | Tileset and terrain generation |
| `animation` | Animation sequence generation |

## Description

The `prompts` command provides ready-to-use prompt templates for generating Pixelsrc content with AI models. Each template includes:
- Clear instructions for the AI
- Format specifications
- Example output structure
- Common parameters to customize

## Examples

### List available templates

```bash
# Show all available templates
pxl prompts
```

### Get specific template

```bash
# Get character sprite template
pxl prompts character

# Get animation template
pxl prompts animation
```

### Use with AI tools

```bash
# Copy template to clipboard (macOS)
pxl prompts character | pbcopy

# Pipe to AI tool
pxl prompts character | ai-chat --model gpt-4

# Save template for editing
pxl prompts tileset > tileset-prompt.txt
```

### Preview AI output quickly

```bash
# After generating sprite, preview in terminal
pxl show sprite.pxl -s character

# View with coordinates for debugging
pxl grid sprite.pxl -s character

# Get structural breakdown
pxl explain sprite.pxl -s character
```

## Sample Template Output

```
# Character Sprite Generation

Generate a pixel art character sprite in Pixelsrc format.

## Requirements
- Size: 16x16 pixels
- Style: Retro game aesthetic
- Include: Front-facing idle pose

## Output Format
Create a palette with 4-8 colors, then a sprite referencing those colors.

Example structure:
```
palette:
  name: character_colors
  colors:
    outline: #000000
    skin: #E0A070
    ...

sprite:
  name: character
  palette: character_colors
  grid:
    _ _ _ _ ...
```

## Guidelines
- Use `_` for transparent pixels
- Keep outlines consistent (usually 1px black)
- Center the character in the grid
...
```

## Use Cases

- **Quick start**: Get working prompts without writing from scratch
- **Consistency**: Ensure AI outputs match expected format
- **Training**: Understand effective prompt structure
- **Integration**: Build into AI-powered workflows

## See Also

- [prime](prime.md) - Format specification for context injection
- [validate](validate.md) - Validate AI-generated output
- [suggest](suggest.md) - Fix common AI generation errors