Creative Illustration Factory

Generate professional illustrations for books, editorial content, children's stories, and creative projects.

Setup

• Needs env: OPENAI_API_KEY

Quick Start

Generate a simple illustration:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "a cozy cottage in an enchanted forest"

Generate with specific style:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "a robot learning to paint" \
  --style "watercolor" \
  --mood "whimsical"

Generate a story sequence:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "Alice discovers a tiny door" \
  --subject "Alice shrinks down" \
  --subject "Alice enters Wonderland" \
  --style "whimsical illustration" \
  --mood "magical"

Illustration Types

Book Illustrations

• chapter-opener - Full-page chapter opening scene
• character-intro - Character introduction portrait
• landscape-scene - Wide landscape establishing shot
• action-moment - Dynamic action or pivotal moment
• emotional-scene - Emotional or dramatic scene
• cover-art - Book cover illustration style

Editorial / Magazine Art

• conceptual-art - Abstract conceptual illustration
• info-graphic - Informational illustration style
• portrait-editorial - Editorial portrait
• spot-illustration - Small spot illustration
• full-page-spread - Magazine full-page spread

Children's Book Art

• picture-book - Classic picture book illustration
• whimsical - Playful and imaginative style
• educational - Educational book illustration
• bedtime-story - Soft, calming bedtime story art
• adventure-map - Adventure map or treasure map

Concept Art

• environment-concept - Environmental concept art
• character-concept - Character design concept
• prop-concept - Object or prop design
• storyboard - Storyboard panel style
• mood-board - Mood board aesthetic

Styles

Traditional Media

• watercolor - Watercolor painting with soft edges
• oil-painting - Rich oil painting texture
• charcoal-sketch - Charcoal drawing style
• ink-wash - Ink wash / sumi-e style
• pastel - Soft pastel drawing
• colored-pencil - Colored pencil illustration
• gouache - Gouache opaque watercolor
• acrylic - Acrylic painting style
• lino-cut - Linocut printmaking style
• woodcut - Woodcut print aesthetic

Digital Styles

• digital-painting - Digital painting
• vector-illustration - Clean vector art
• flat-design - Flat design aesthetic
• isometric - Isometric perspective
• pixel-art - Retro pixel art
• concept-art - Game/film concept art style
• cel-shaded - Cel shaded animation style
• low-poly - Low poly 3D aesthetic

Book & Print Styles

• picture-book - Classic picture book
• storybook-illustration - Vintage storybook art
• editorial-illustration - Magazine editorial
• newspaper-engraving - Newspaper engraving style
• poster-art - Vintage poster design
• woodblock-print - Japanese woodblock print
• screen-print - Screen print aesthetic

Mood

• whimsical - Playful and imaginative
• magical - Magical and enchanting
• mysterious - Mysterious and intriguing
• peaceful - Calm and serene
• dramatic - Dramatic and intense
• nostalgic - Warm and nostalgic
• gloomy - Dark and atmospheric
• vibrant - Bright and energetic
• romantic - Soft and romantic
• quirky - Quirky and eccentric

Parameters

• --subject - Illustration subject/description (repeatable for batch)
• --type - Illustration type (default: illustration)
• --style - Artistic style (default: watercolor)
• --mood - Mood/atmosphere (default: peaceful)
• --palette - Color palette suggestion
• --composition - Composition guidance (e.g., "wide shot", "close-up")
• --count - Number of variants per subject (default: 1)
• --out-dir - Output directory (default: ~/Projects/tmp/creative-illustration-*)
• --size - Image size: 1024x1024, 1792x1024, 1024x1792 (default: 1024x1024)
• --quality - high/standard (default: high)
• --model - OpenAI image model (default: gpt-image-1.5)
• --api-key - OpenAI API key (or use OPENAI_API_KEY env)

Advanced Examples

Children's book page:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "a curious rabbit with a pocket watch" \
  --type "picture-book" \
  --style "watercolor" \
  --mood "whimsical" \
  --palette "pastel"

Editorial concept art:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "AI and humanity working together" \
  --type "conceptual-art" \
  --style "vector-illustration" \
  --mood "optimistic" \
  --composition "symbolic"

Story sequence:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "Hero finds an ancient map" \
  --subject "Hero deciphers mysterious symbols" \
  --subject "Hero discovers a hidden passage" \
  --subject "Hero enters the forgotten temple" \
  --style "storybook-illustration" \
  --mood "mysterious" \
  --palette "earth tones"

Full custom prompt:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --prompt "A magical treehouse library nestled among ancient redwoods, spiral staircase winding up the trunk, lanterns hanging from branches, books floating in mid-air, warm golden light streaming through leaves, detailed watercolor illustration style, whimsical and enchanting"

Color Palettes

• pastel - Soft pastel colors
• earth tones - Natural browns, greens, golds
• vibrant - Bright saturated colors
• muted - Desaturated, subtle colors
• monochrome - Single color variations
• jewel tones - Rich ruby, emerald, sapphire
• autumn - Orange, red, yellow, brown
• winter - Blue, white, silver, purple
• tropical - Bright greens, teals, pinks
• vintage - Warm sepia, faded tones

Composition

• wide shot - Wide establishing scene
• close-up - Intimate close-up
• panoramic - Panoramic landscape
• rule-of-thirds - Balanced rule of thirds
• centered - Centered subject
• diagonal - Dynamic diagonal composition
• triangular - Triangular composition
• circular - Circular / spiral composition
• symmetrical - Perfectly symmetrical
• asymmetrical - Asymmetrical balance

Output

• *.png - Illustration images
• prompts.json - All prompts used
• index.html - Illustration gallery

Project Templates

Children's Book (4-6 images)

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "Girl finds a magical seed" \
  --subject "Seed grows into a glowing plant" \
  --subject "Plant reveals a tiny fairy" \
  --subject "Fairy shows girl a secret garden" \
  --subject "Girl shares garden with friends" \
  --type "picture-book" \
  --style "watercolor" \
  --mood "whimsical"

Magazine Editorial (1-2 images)

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "The future of sustainable cities" \
  --type "conceptual-art" \
  --style "vector-illustration" \
  --mood "optimistic" \
  --count 2

Fantasy Story Chapter Opener (1 image)

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "The dragon's treasure hoard under ancient runes" \
  --type "chapter-opener" \
  --style "oil-painting" \
  --mood "dramatic" \
  --palette "jewel tones"