Create Image

Universal AI image generation plugin for Claude Code with comprehensive template management, style references, and multi-provider support.

When to Use

Use this skill when:

• •Generating AI images from text prompts
• •Managing illustration templates and styles
• •Configuring style references for consistent visual output
• •Editing domain knowledge (system instructions) for image generation
• •Switching between image generation providers (Gemini, OpenRouter, VertexAI)

Quick Start

# Generate an image
/create-image "A pickleball player demonstrating the serve technique"

# List available templates
/create-image-templates

# Manage style references
/create-image-refs illustrative

# Update domain knowledge
/create-image-rules illustrative

Available Commands

Template Management

List Templates

Shows all available templates with metadata:

• •Template name (topic/style format)
• •Description
• •Active status
• •Style references count
• •Domain knowledge lines

Style References

Style references are image grids that guide the visual style of generated images. The plugin supports:

• •Listing: View all style references for a template
• •Activating: Set which reference is used by default
• •Generating: Create new style reference grids with Nano Banana Pro

Domain Knowledge

Domain knowledge files contain rules and instructions that are injected as system prompts during image generation. They ensure:

• •Accurate sport/domain representation
• •Correct positioning and proportions
• •Equipment and context accuracy
• •Common AI mistake prevention

Provider Management

Supported Providers

Automatic Fallback

When enabled, the plugin automatically tries the next provider if the primary fails:

Gemini -> VertexAI -> OpenRouter

Configuration

Configuration is loaded from:

1. •~/.config/create-image/config.yaml (user config)
2. •Environment variables (API keys)
3. •Runtime overrides

Environment Variables

Config File Example

# ~/.config/create-image/config.yaml
repositoryPath: ~/Documents/github/image-generator
defaultProvider: gemini
autoFallback: true
cacheEnabled: true
cacheTTL: 3600000

# defaultTemplate: sports/illustrative

Template Structure

Templates follow the topic/style format and are stored in: {repositoryPath}/templates/{topic}/{style}/

templates/sports/illustrative/
  config.json           # Template metadata
  style-guide.json      # Visual style specification
  domain-knowledge.txt  # System instructions
  .active-reference     # Currently active style reference
  style-references/     # Style reference images
    modern-minimalist-01.png
    ...
  prompts/              # Type-specific prompt templates
    serve-technique.txt
    court-diagram.txt
    ...

Image Types

Templates can support multiple image types with specialized prompts:

• •serve-technique - Serve demonstrations
• •court-diagram - Overhead court views
• •player-position - Player positioning
• •rule-infographic - Rule explanations
• •violation-scenario - Violation depictions
• •referee-position - Referee positioning

Usage Examples

Generate with Specific Template

/create-image "Player at kitchen line executing a dink shot" --template sports/illustrative --type dink-technique

Generate with Style Reference

/create-image "Serve technique demonstration" --style-grid modern-minimalist-01.png

Check System Status

# View all templates
/create-image-templates

# Check provider health
/create-image-health

# View configuration
/create-image-config

Caching

The plugin caches:

• •Template configurations (1 hour default TTL)
• •Provider health checks (5 minutes)
• •Template registry (until manually rebuilt)

Clear caches with configuration reload if templates are updated.

Related

• •Web UI: Access template management via your project's /illustrations page
• •External Repo: ~/Documents/github/image-generator
• •Configuration: ~/.config/create-image/config.yaml