Quality Posters

A poster generator with a curated catalog of 31 visual styles. The agent picks the style that fits the brief, builds the prompt, and generates with GPT Image 2.

After generation, layer separation is handled outside this skill — open the PNG in Canva and use Magic / Smart Layers to split foreground/background/text for editing.

How to Run

generate.js lives at the project root (alongside styles.js). This skill folder holds only SKILL.md.

cd <repo-root>
node generate.js "<brief>"                         # auto-pick style
node generate.js "<brief>" --style=<style_id>      # force a style
node generate.js "<brief>" --n=3                   # 3 design variations
node generate.js "<brief>" --style=<style_id> --n=3

The script reads FAL_KEY from .env at the project root. Output PNGs go to ./out/.

When the User Says "Make a Poster"

1. Read the brief. Identify mood (calm / vibrant / nostalgic / mystical / luxury / corporate / playful) and subject (event / product / album / movie / listing / retreat).
2. Pick the best matching style from the catalog using the Style Picker rules below. If two styles fit, pick the more distinctive one — the user can ask for a different style if it misses.
3. Tell the user which style you picked and why (one sentence).
4. Run generate.js. Default to --n=1. If they say "more designs" or "variations", run with --n=3 (or the number they ask for).
5. After it saves, give them the file path and remind them: open in Canva and use Magic Layers if they want to edit the text or swap the subject.

Style Picker (auto-match by brief intent)

If nothing matches confidently, ask the user to pick from a 3-option shortlist of the closest styles.

Style Catalog

Each style is a self-contained prompt template defined in styles.js. The fields the agent fills in vary by style (title, subtitle, date, location, etc.) — the template tells the user what's needed. Common fields:

• title — main headline
• subtitle — supporting line or kicker
• body — small block of text (lineup, quote, listing details)
• footer — date / venue / billing block
• subject — the central illustrated or photographed element

If a field isn't provided, leave it generic (e.g. "EVENT NAME · CITY · DATE") rather than ask 5 questions.

Catalog (31 styles)

1. cinematic-neonoir — rainy Tokyo alley, neon, distressed serif title, fake billing block
2. vintage-travel — 1950s WPA / Roger Broders, flat color, cobalt + cream + red
3. swiss-minimal-typo — pure white, single geometric shape, Helvetica stack, generous space
4. tech-conf-darkmode — charcoal, abstract chrome sculpture, geometric sans-serif title, monospace footer
5. corporate-report — premium off-white, single editorial photo, Didone serif, refined whitespace
6. indie-gig-riso — risograph two-color, halftone collage, hand-cut zine feel
7. luxury-real-estate — listing flyer, photo top 2/3, forest-green serif, three-column data block (uses --ref=<image>)
8. luxury-estate-cover — full-bleed dusk estate photo, Didone "QUIET MAJESTY", magazine-cover restraint
9. art-deco — gold geometric sunburst on midnight black, tall condensed serif, mirrored ornament
10. bauhaus-geometric — primary red/blue/yellow shapes, lowercase sans, hairline rules
11. ukiyo-e — Japanese woodblock, great wave or Fuji, vertical kanji column + small hanko seal
12. psychedelic-60s — Fillmore-era hand-drawn melting bubble lettering, hot magenta + lime + tangerine
13. vaporwave-synth — sunset gradient, chrome floor grid, roman bust, glowing pink + cyan title
14. saul-bass-minimal — single torn-paper graphic on cream, two-pass screen print
15. memphis-80s — mint background, clashing terrazzo and zigzag patterns, chunky multicolor type
16. editorial-fashion — full-bleed studio portrait, tall serif masthead, vertical cover lines
17. symmetric-storybook — perfectly symmetric pastel diorama, mustard Futura, decorative deco border
18. pop-art-comic — Ben-Day dots, bold black ink outlines, comic speech burst
19. pastel-mindful — dusty rose to sage gouache wash, ceramic teacup, light serif typography
20. sumi-e-zen — rice paper, single bamboo brushstroke, vast negative space, vermilion hanko
21. loteria-folk — vibrant Mexican folk-art, papel-picado border, marigold + sapphire + cactus green
22. surreal-dreamscape — clear sky raining apples, floating doorway, painterly oil-on-canvas
23. documentary-portrait — Magnum-style B&W reportage portrait, harsh natural light, exhibition poster
24. sports-action-hero — stadium-night runner mid-stride, lens flares, stencil sans + tangerine
25. album-cover-portrait — 70s soul-funk vinyl cover, mustard band + serif title, warm tungsten light
26. post-apoc-sword — Korean AAA action-RPG key art, female warrior + glowing blade, ruined megacity
27. lone-traveler-cargo — melancholic sci-fi wanderer with cargo stack, Icelandic ash plain, golden particulate
28. neon-noir-cyberpunk — rain-soaked megacity, hologram billboards, anamorphic flares, cinematic 70mm
29. streetwear-lookbook — concrete studio backdrop, oversized cargo + hoodie, Tokyo-NYC editorial
30. minimal-tech-keynote — pure black, single floating product hero, ultra-thin lowercase sans, generous whitespace
31. absurd-transit-map — Vignelli subway diagram, coloured route lines, stations named after emotional states

Generation Settings (locked)

endpoint:    https://fal.run/openai/gpt-image-2
image_size:  portrait_16_9
quality:     medium
num_images:  1 (per --n)
output:      png

For luxury-real-estate with a photo reference, use https://fal.run/openai/gpt-image-2/edit and pass the uploaded image URL (any S3/CDN URL works; the script handles upload via Kie if a Kie key is in .env).

Rules

• Anonymize — don't put a real person's name or a known brand in the prompt unless the user explicitly asks. Use generic stand-ins (e.g. "Acme Holdings" not a real company).
• Don't oversell calm styles — for pastel-mindful and sumi-e-zen, restraint is the whole point. Don't load the prompt with extra elements.
• Footer billing line is always last — date · venue · price/credit.
• Title rendering — GPT Image 2 is strong on typography but not perfect. If a title has more than ~6 words, expect typos. Suggest shortening.
• Variations — when running --n=3, vary the subject slightly (different colour accent, different framing) rather than the same prompt 3×.

Out of Scope

• No PSD layering. Direct the user to Canva → Magic / Smart Layers for foreground/background/text separation and editing.
• No upscaling. Output is whatever GPT Image 2 returns.
• No animation. This is a still-image skill.