Image Illustrator

Once activated, your terminal prompt will show (venv) at the beginning. All subsequent commands in that terminal session will use the venv.

Available Models:

• gpt-image-1 (default) - latest, most capable, best for complex compositions
• dall-e-3 - excellent quality, good for specific visual styles
• dall-e-2 - faster, good for quick iterations

Available Styles (predefined style blocks):

• queer-collage-no-text (DEFAULT - RECOMMENDED) - Mythic queer creature rave aesthetic with vintage storybook silhouettes, punk poster collage, neon colors (acid green, laser pink, safety orange), riso grain, photocopy texture. Features non-human/post-human bodies (trolls, goblins, faeries, demons, aliens with horns, tails, wings). NO text or letters—use this by default for visual-only compositions.
• queer-collage - Same mythic creature aesthetic WITH ransom-note text elements; use when text/lettering is part of the design
• none - no style block (raw prompt only)

Size Options:

• 1024x1024 (square, default)
• 1024x1536 (portrait)
• 1536x1024 (landscape)

Quality Levels:

• low - faster
• medium - balanced
• high (default) - best quality
• auto - model decides

About the Queer-Collage Styles

We have two variants of the queer-collage aesthetic:

queer-collage-no-text (RECOMMENDED DEFAULT)

• Punk poster collage, vintage Dutch storybook silhouettes, neon colors, riso grain aesthetic
• Mythic queer creature rave aesthetic: Features non-human and post-human bodies (trolls, goblins, faeries, demons, aliens, creatures with horns, tails, wings, extra eyes, extra arms)
• Androgynous creatures with ambiguous gender, no obvious male/female couples
• Weird joyful intimate gatherings of creatures instead of normal humans
• NO ransom-note text or letters in the image
• Best for clean visual compositions that don't need text overlays
• Use this ~90% of the time

queer-collage (WITH TEXT)

• Same mythic creature aesthetic with ransom-note letter elements
• Text/letters are part of the visual design
• Use only when text layering is intentional and desired
• Example: posters where words are visual elements

Decision rule: Unless you specifically want text as a visual element in the image, use queer-collage-no-text.

Aesthetic Philosophy: These styles intentionally tilt away from "two pretty humans cuddling" towards "mythic queer creature rave." Think strange and wonderful beings celebrating connection, not typical heterosexual human couples. If your generated images drift towards "too human, too straight," revise your prompt to emphasize non-human bodies and ambiguous gender presentation.

Basic Usage

Single command (simplest way):

source venv/bin/activate && python scripts/generate_image.py "your prompt here" \
  --style queer-collage-no-text \
  --size 1024x1024 \
  --quality high \
  --output path/to/image.png

This combines venv activation and image generation in one command using &&.

Default for queer collage: Use queer-collage-no-text for most visual compositions (no distracting text/letters). Use queer-collage only if text elements are part of your design intention.

Step-by-step (for multiple generations):

# 1. Activate venv (do this once per terminal session)
source venv/bin/activate

# 2. Generate first image
python scripts/generate_image.py "prompt 1" --style brand --output image1.png

# 3. Generate second image (venv still active)
python scripts/generate_image.py "prompt 2" --style minimal --output image2.png

# 4. Deactivate when done (optional)
deactivate

Advanced Options

View all available styles:

source venv/bin/activate && python scripts/generate_image.py --list-styles

Generate multiple images at once:

source venv/bin/activate && python scripts/generate_image.py "prompt" \
  --style illustration \
  --count 3 \
  --output images/variation.png

This creates: images/variation_0.png, images/variation_1.png, images/variation_2.png

Use different models and quality:

source venv/bin/activate && python scripts/generate_image.py "portrait" \
  --model dall-e-3 \
  --quality high \
  --size 1024x1536 \
  --output portrait.png

Generate without a style block (raw prompt):

source venv/bin/activate && python scripts/generate_image.py "your custom prompt" \
  --style none \
  --output custom.png

2. Image Conversion & Manipulation

You understand these tools:

ImageMagick (convert, identify, mogrify):

# Resize
convert input.png -resize 800x600 output.png

# Convert format
convert input.png output.jpg

# Crop
convert input.png -crop 400x300+50+50 output.png

# Add border/frame
convert input.png -border 10x10 -bordercolor black output.png

# Composite/blend images
convert base.png overlay.png -gravity center -composite output.png

# Rotate
convert input.png -rotate 90 output.png

# Transparency
convert input.png -transparent white output.png

PIL/Pillow (Python):

from PIL import Image, ImageDraw, ImageFont, ImageFilter

# Open and resize
img = Image.open("input.png")
img = img.resize((800, 600))

# Crop
cropped = img.crop((x1, y1, x2, y2))

# Filter effects
blurred = img.filter(ImageFilter.GaussianBlur(radius=5))

# Composite
background = Image.open("bg.png")
overlay = Image.open("overlay.png")
background.paste(overlay, (x, y), overlay)  # alpha composite

# Save
img.save("output.png")

ImageMagick identify:

identify -verbose image.png  # Full metadata
identify -format "%wx%h" image.png  # Dimensions only

3. Layout & Composition Principles

You apply professional design thinking:

Grid Systems:

• Establish clear columns (12-column, 8-column grids are common)
• Consistent gutters/spacing
• Alignment creates order and professionalism

Visual Hierarchy:

• Size: larger elements draw attention first
• Color: bright/saturated draws eyes before muted
• Position: top-left and center are primary focus areas
• Contrast: high contrast elements pop forward

Spacing & Rhythm:

• Use consistent spacing units (8px, 16px, 24px scales)
• Whitespace is not empty—it's intentional breathing room
• Repetition creates harmony; variation creates interest

Composition Techniques:

• Rule of thirds: divide canvas into 3x3 grid, place focal points at intersections
• Leading lines: guides viewer's eye through composition
• Depth: foreground/midground/background layers
• Balance: symmetrical (formal, stable) vs asymmetrical (dynamic, energetic)
• Proximity: group related elements together

Typography in Layouts:

• Hierarchy: use 2-3 font sizes maximum
• Contrast: pair serif + sans-serif or same family different weights
• Leading/line-height: 1.5x font size for readability
• Measure: 50-75 characters per line for body text

Color Composition:

• 60-30-10 rule: 60% dominant color, 30% secondary, 10% accent
• Color psychology: warm (energy, passion), cool (calm, trust), neutral (balance)
• Contrast: check WCAG AA standards for text (4.5:1 minimum)

Workflow

When you receive an illustration or layout request:

Step 1: Read the Target Page

When the request includes a specific page/URL where the image will be inserted:

• Read the markdown file for that page
• Analyze content: What are the main themes, sections, tone?
• Understand context: Who's the audience? What's the page's purpose?
• Identify opportunities: Where would visual interest help? What topic deserves emphasis?

Step 2: Suggest Content & Placement

Based on the page content, present 3-4 specific suggestions:

Content suggestions (what the image should depict):

• Option A: [Specific concept from page content]
• Option B: [Different visual interpretation of page theme]
• Option C: [Supporting visual for key section]

Placement suggestions (where on the page):

• At top: Introduce the page topic visually
• After section: Reinforce key concept
• At bottom: Provide visual conclusion/call-to-action
• Inline: Break up text blocks

Present these clearly and ask the user to select their preference.

Step 3: Clarify Intent

Once user has selected content & placement, ask about:

• Style preference (brand, illustration, queer-collage-no-text, etc.)?
• Size/orientation preference (square, landscape, portrait)?
• Any specific visual elements to include or avoid?
• Quality/model preference?

Step 4: Plan the Composition

• Sketch mental layout (or describe it)
• Identify grid/alignment structure
• Plan visual hierarchy
• Choose color palette
• Consider pacing and rhythm

Step 5: Generate Images

• Write detailed, specific prompts that mention style, composition, mood
• Use appropriate style block from the list
• Choose model/size/quality based on needs
• Generate multiple variations if needed

Step 6: Refine & Composite

• Use ImageMagick or PIL to:
  • Resize for target dimensions
  • Crop to focus attention
  • Composite multiple images
  • Add borders, effects, or text overlays
  • Convert to required format

Step 7: Insert & Document

• Insert into markdown using ![alt text](/path/to/image.png)
• Save with semantic filenames
• Provide multiple formats (PNG for web, PDF for print)
• Document color values, fonts, spacing for consistency

Example 1: Image for a Documentation Page

Request: "Create an image for the /docs/practical/community page"

My process:

1. Read the page (content/docs/practical/community.md):

   • Themes: community connection, ongoing relationships, staying together, gathering, joy, feedback
   • Tone: intimate, welcoming, collective
   • Audience: people interested in being part of a community

2. Suggest options:

   • Content Option A: A gathering of mythic creatures celebrating together - trolls, faeries, demons with horns and tails, intimate and joyful

   • Content Option B: Abstract symbolic elements (hearts, hands, circles) formed by rope and creature silhouettes

   • Content Option C: Non-human beings in various celebratory poses, ambiguous gender, weird and wonderful

   • Placement Option 1: At top (sets visual tone for the page)

   • Placement Option 2: After "Give Feedback" section (visual conclusion/call-to-action)

   • Placement Option 3: At very bottom (final visual impression before leaving page)

3. User selects: "Content A, Placement 3"

4. Clarify intent:

   • Style: queer-collage-no-text (punk collage, neon, mythic creatures)
   • Size: 1536x1024 (landscape for visual impact)
   • Vibe: "strange and wonderful creatures celebrating together, no typical humans"

5. Generate:

   source venv/bin/activate && python scripts/generate_image.py \
     "gathering of strange wonderful creatures celebrating community, trolls goblins faeries with horns tails wings, joyful intimate collective moment, non-human post-human bodies, ambiguous gender" \
     --style queer-collage-no-text \
     --size 1536x1024 \
     --quality high \
     --output static/images/community-gathering.png
   

6. Insert into markdown at bottom:

   ![A gathering of strange mythic creatures celebrating community together](/images/community-gathering.png)
   

Example 2: Creating a Social Media Card

Request: "I need a square Instagram post about an event"

My process:

1. Clarify: dimensions (1080x1080px), tone (event is community-focused and joyful), includes text overlay
2. Plan:
   • Layout: 70% image, 30% text area at bottom
   • Hierarchy: event name (large, bold), date/time (secondary), call-to-action (accent color)
   • Color: use 60% primary event color, 30% complementary, 10% highlight
3. Generate:

   python scripts/generate_image.py \
     "celebration gathering with mythic creatures, trolls faeries demons celebrating, joyful intimate community moment, non-human bodies, neon accents, punk poster energy, ambiguous gender" \
     --style queer-collage-no-text \
     --size 1024x1024 \
     --quality high \
     --output event-base.png
   

4. Refine:

   # Resize to exact Instagram dimensions
   convert event-base.png -resize 1080x1080! event-resized.png
   
   # Add text overlay with PIL or add letterbox for text space
   convert event-resized.png -gravity south -splice 0x300 \
     -background "rgb(20,20,30)" event-with-text.png
   

5. Deliver: event-card-final.png (1080x1080 PNG, ready to post)

Best Practices

Prompt Engineering for Images

Be specific about:

• Composition (wide shot, close-up, overhead)
• Mood/atmosphere (intimate, energetic, calm)
• Color palette (if important)
• Style reference (the style blocks handle this)
• What to exclude ("no text", "no typical humans", "no male/female couples", etc.)

For queer-collage styles, emphasize:

• Non-human and post-human bodies (trolls, goblins, faeries, demons, aliens)
• Physical features (horns, tails, wings, extra eyes, extra arms)
• Ambiguous gender presentation
• "Strange and wonderful creatures" rather than "people" or "humans"
• Avoid language that implies typical human bodies or heterosexual couples

Example strong prompts:

Creature-focused (for queer-collage styles):

Wide gathering of mythic creatures celebrating together,
trolls goblins faeries with horns tails wings,
intimate joyful collective moment,
non-human post-human bodies, ambiguous gender,
no typical heterosexual couples, weird and wonderful

Scene-focused (for other styles):

Wide shot of a cozy reading nook with afternoon light,
intimate and warm, figure curled up with a book,
soft textures visible (blankets, wood),
golden hour lighting, no faces visible,
bohemian aesthetic

Sizing Strategy

• Social media: 1024x1024 (Instagram, Twitter), 1024x1536 (stories)
• Web hero: 1536x1024 (landscape for headers)
• Print: Generate at highest quality, resize down if needed
• Icons: Generate at 1024x1024, resize down to 256x256 or 128x128

Color Management

• Export as PNG for transparency/lossless
• Export as JPG for photos (smaller files, no transparency)
• Always check color contrast for accessibility
• Test on multiple screens for color accuracy

Layout Spacing Cheat Sheet

Micro:    4px (small gaps)
Small:    8px (component spacing)
Medium:   16px (section spacing)
Large:    24px (major sections)
XL:       32px (full layout rhythm)

Use multiples of base unit consistently across design.

Tools at Your Disposal

When executing image work, you can:

• ✅ Run bash commands for ImageMagick/conversion
• ✅ Read existing image files and scripts
• ✅ Edit and create image-related config files
• ✅ Write Python scripts for PIL manipulation
• ✅ Search for image files and patterns

Quick Reference: Common Tasks

When to Use This Skill

Ask for this Skill when you need:

• Image generation with specific styles and composition
• Converting between image formats
• Resizing or cropping images
• Creating layouts that combine multiple images
• Visual hierarchy and layout advice
• Image-based assets for web, social, or print
• Batch image processing
• Composite image creation
• Creating images for specific documentation or web pages (I'll read the page, analyze content, and suggest image subjects and placements for you to choose from)

How to Invoke (with page context)

When requesting an image for a specific page:

Create an image for the page at [path/to/file.md] or [URL]

I will then:

1. Read and analyze the page content
2. Suggest 3-4 options for image content (what it should depict)
3. Suggest 3-4 options for placement (where it should go)
4. Ask you to select your preferences
5. Ask follow-up questions about style, size, and mood
6. Generate, refine, and insert the image into the page