MadAppGang plugin: image-generate updated: 2026-01-20
Style Format Specification
Overview
Styles are single markdown files in the styles/ directory.
The entire file content is prepended to the user's prompt.
File Location
{project}/
styles/
glass.md
watercolor.md
cyberpunk.md
Template Structure
# Style Name
{Overall description of the visual style. Be vivid and specific.
Include mood, atmosphere, key visual characteristics.}
## Color Palette
- Primary: {color} ({hex})
- Secondary: {color} ({hex})
- Background: {color} ({hex})
- Accents: {colors}
## Technical Notes
{Rendering style, lighting, materials, post-processing}
Example: Blue Glass 3D
# Blue Glass 3D Style
A photorealistic 3D render with blue glass material. Objects should have:
- Glossy, translucent blue glass surface
- Subtle reflections and refractions
- Solid black background
- Soft studio lighting from above-left
- Sharp shadows
## Color Palette
- Primary: Deep blue (#1a4b8c)
- Highlights: Light cyan (#7fdbff)
- Background: Pure black (#000000)
## Technical Notes
- Use ray-traced rendering appearance
- Include caustic light effects
- Maintain consistent material across objects
Usage
# Apply style to generation
uv run python main.py out.png "gear icon" --style styles/glass.md
# Combine with reference
uv run python main.py out.png "cube" --style styles/glass.md --ref prev.png
Style vs Reference
| Concept | Type | Purpose |
|---|---|---|
| Style | Text (.md) | Artistic direction via description |
| Reference | Image | Visual example for consistency |
Both can be combined for best results.
Security Notes
Style files are validated for potential injection patterns:
- No bash/shell code blocks
- No variable expansion (${ })
- No command substitution ($( ))
- No shell operators (& | ; `)
Suspicious patterns block creation. The style-manager agent returns NEEDS CONFIRMATION
with the flagged content quoted and writes the file only on a CONFIRMED: re-dispatch; a
main-thread caller asks the user before writing.
Writing Effective Styles
- Be Specific: "Soft watercolor washes with visible paper texture"
- Include Colors: Hex codes ensure consistency
- Describe Mood: "Mysterious, slightly unsettling"
- Technical Details: Lighting, camera angle, rendering style
- Keep It Focused: One style per file