image-generation

Image Generation

Convert a fuzzy image request into prompt specs precise enough that any competent image model — and specifically fal-ai/nano-banana-pro on FAL.ai, the one model this repo's automation uses — renders what the user actually pictured. The prompt spec is the deliverable; generated files are the bonus when the automation is configured. Prime rule: never generate from a vague prompt. A weak prompt costs a generation credit and teaches you nothing; a sharp spec is reusable forever.

When to use / when not to

Use for general-purpose images: hero images, illustrations, thumbnails, infographics, textures, concept art, any one-off visual. Hand off instead when the request is really:

• Product shots for commerce/marketing → skills/creative/product-photography
• Platform-sized social content → skills/creative/social-graphics
• Logos, icons, patterns, brand marks → skills/creative/brand-asset
• No visual direction exists yet and consistency matters → run skills/creative/creative-strategist first and consume its style block
• A whole multi-asset campaign → skills/creative/orchestrator routes it

Intake

Ask in one batch, only what's missing:

1. Subject — what exactly is in the image? (object, scene, people, text?)
2. Use — where does it go? (this decides aspect ratio and resolution)
3. Style anchor — existing style guide / creative-strategist style block, reference images, or 3 adjectives for the mood?
4. Automation — is FAL_API_KEY set so you can generate, or deliver specs only?

Infer, don't ask: aspect ratio from the stated destination (thumbnail → 16:9, story → 9:16, feed → 1:1 or 4:5); resolution from stakes (2K default, 4K hero/print, 1K drafts). Don't stall: if subject and use are clear, state your assumptions for the rest and proceed.

Workflow

1. Check for a style block. If the user has run skills/creative/creative-strategist, reuse its style block verbatim in every prompt. If not, and this is a one-off, derive a minimal one (style + palette + mood) from context and label it an assumption.
2. Draft the prompt with the 5-part formula. Every prompt contains, in order: subject (the main thing, specific: "a luxury leather watch with gold accents", never "a watch") → descriptive detail (materials, colors, text to render) → style ("professional product photography", "flat modern illustration", "photorealistic") → technical treatment (lighting, composition, focus, "4K, highly detailed") → mood ("warm and inviting"). Add negative constraints as plain prohibitions ("no text overlay", "no watermark", "no busy background").
3. Decide variant strategy. If it's a throwaway draft → 1 image at 1K. If it's a keeper asset → propose 3–4 genuinely distinct prompt specs (different composition or style angle, not synonym swaps), generate 1 of each or num_images 3–4 of the winner, and have the user pick. Never present one option for a hero asset.
4. Generate or deliver. If FAL_API_KEY (or FAL_KEY) is set: