Image Compose

Handles every flavor of image generation for filmmaking projects: character portraits, location establishes, edits, variations, and storyboard mosaics. Routes between standard and pro tiers depending on use case. The standout piece is the built-in character design pre-flight that asks whether the character will appear in downstream video work. If yes, it defaults to a 4-panel reference sheet (front, profile, back, closeup) instead of a single portrait, because video models need multi-view anchor data to maintain identity consistency across shots. Also includes templated prompt structures for each pattern, provenance edge wiring, and explicit guidance on when to use storyboard composites versus single-panel calls. Written for projects where images feed into later video generation, not standalone illustration work.

GitHub stars: 293
last updated: Jun 9, 2026

View on GitHub

Install

$ npx -y skills add utopai-research/pai-pro --skill image-compose --agent claude-code

Installs into .claude/skills of the current project.

Files

CLI shape

Standard tier:

node "$PAI_REPO_ROOT/server/cli/generate_image.js" --prompt "..." [--aspect-ratio 16:9] [--image-size 2K] [--label "..."] [--subtype <character|location|edit|reference|split|storyboard>] [--name "..."] [--role "..."] [--description "..."] [--source-node-id <id>] [--ref-source-id <id> ...]

Pro tier for storyboard mosaics and video-bound character sheets:

node "$PAI_REPO_ROOT/server/cli/generate_image_pro.js" --prompt "..." --size 2560x1440 [--label "..."] [--subtype <character|location|edit|reference|split|storyboard>] [--name "..."] [--role "..."] [--description "..."] [--source-node-id <id>] [--ref-source-id <id> ...]

Pro accepts --size only; no --aspect-ratio / --image-size. Common sizes: 1024x1024, 1280x720, 720x1280, 1920x1920, 2560x1440, 1440x2560, 3840x2160, 2160x3840.