synabun 1.3.0

package/skills/leonardo/modules/model-advisor.md

@@ -0,0 +1,100 @@
+# Model Advisor — Reference Guide
+
+Quick reference for Leonardo.ai model selection. Use this when you need to recommend the best model for a specific use case.
+
+---
+
+## Image Models — Decision Matrix
+
+| Use Case | Best Model | Why | Cost |
+|----------|-----------|-----|------|
+| Photorealistic portraits | Lucid Realism | Cinematic realism, pairs w/ video | Unlimited |
+| Product photography | GPT Image-1.5 | Superior editing & detail | Paid |
+| Landscapes & architecture | FLUX.2 Pro | High-fidelity, prompt adherence | Paid |
+| Concept art & illustration | FLUX Dev | Creative flexibility, style ref | Unlimited |
+| Anime/Manga | Phoenix 1.0 + style preset | Preset support, character ref | Unlimited |
+| Text in images / logos | Ideogram 3.0 or Seedream 4.5 | Best text rendering | Paid |
+| Quick iterations | FLUX Schnell | Fastest free model | Unlimited |
+| Maximum quality | Seedream 4.5 | Ultra quality, posters/logos | Paid |
+| Style transfer / editing | FLUX.1 Kontext Max | Precise control, max quality | Paid |
+| Context-aware editing | Nano Banana 2 | Fast, sharp, simple editing | Paid |
+| HD with text rendering | Lucid Origin | Prompt adherence + text + HD | Unlimited |
+| Consistency & infographics | Nano Banana Pro | Gemini 3 Pro based | Paid |
+| Budget-conscious | Lucid Origin / FLUX Dev / Phoenix 1.0 | All unlimited/free | Unlimited |
+
+### Model Capabilities Quick Reference
+| Model | Image Ref | Style Ref | Content Ref | Character Ref | Image-to-Image | Elements |
+|-------|-----------|-----------|-------------|---------------|----------------|----------|
+| Lucid Origin | — | Yes | Yes | — | — | — |
+| Lucid Realism | — | Yes | Yes | — | — | — |
+| FLUX Dev | — | Yes | Yes | — | — | Yes |
+| FLUX Schnell | — | Yes | Yes | — | — | — |
+| Phoenix 1.0 | — | Yes | Yes | Yes | Yes | — |
+| Phoenix 0.9 | — | Yes | Yes | Yes | Yes | — |
+| FLUX.2 Pro | — | — | — | — | — | Image Guidance |
+| Nano Banana 2 | Yes | — | — | — | — | — |
+| Seedream 4.5 | Yes | — | — | — | — | — |
+| GPT Image-1.5 | Yes | — | — | — | — | — |
+| Nano Banana Pro | Yes | — | — | — | — | — |
+| Ideogram 3.0 | — | — | — | — | — | — |
+
+---
+
+## Video Models — Decision Matrix
+
+| Use Case | Best Model | Why | Cost |
+|----------|-----------|-----|------|
+| Quick testing / iteration | Motion 2.0 Fast | Fast, free, all controls | Unlimited |
+| Best free quality | Motion 2.0 | Higher quality, all controls | Unlimited |
+| Cinematic storytelling | Veo 3.1 | Start/end frame, audio | ~70 tokens |
+| Fast premium | Veo 3.1 Fast | Quick turnaround | ~35 tokens |
+| Realistic people & audio | Kling Video 3.0 | Longer videos, consistency | ~70 tokens |
+| Voiceovers & sound FX | Kling 2.6 | Natural voiceovers, audio | Paid |
+| Smooth cinematic | Sora 2 Pro | Refined detail, motion | ~70 tokens |
+| Social media (fast + free) | Motion 2.0 Fast | Speed + no cost | Unlimited |
+| Product showcase | Veo 3.1 Fast | Quick, professional | ~35 tokens |
+| Budget premium | LTX-2 Pro / Hailuo 2.3 | Quality per token | ~25 tokens |
+| Multi-instruction prompts | Kling O1 | Exceptional accuracy | Paid |
+| Image ref / start+end frame | Kling Video O3 Omni | Audio + image ref | Paid |
+| Basic subtle motion | Motion 1.0 | Simple image animation | Unlimited |
+
+### Video Model Capabilities
+| Model | Audio | Start Frame | End Frame | Image Ref | Controls | Elements | Styles | Fast |
+|-------|-------|-------------|-----------|-----------|----------|----------|--------|------|
+| Motion 2.0 | — | Yes | — | — | **Yes** | **Yes** | **Yes** | — |
+| Motion 2.0 Fast | — | Yes | — | — | **Yes** | **Yes** | **Yes** | Yes |
+| Motion 1.0 | — | Yes | — | — | — | — | — | — |
+| Kling Video 3.0 | Yes | Yes | Yes | — | — | — | — | — |
+| Kling Video O3 Omni | Yes | Yes | Yes | Yes | — | — | — | — |
+| Kling 2.6 | Yes | Yes | — | — | — | — | — | — |
+| Kling O1 | — | Yes | Yes | Yes | — | — | — | — |
+| Kling 2.5 Turbo | — | Yes | Yes | — | — | — | — | — |
+| Kling 2.5 Turbo Std | — | Yes | — | — | — | — | — | — |
+| Kling 2.1 Pro | — | Yes | Yes | — | — | — | — | — |
+| Veo 3.1 | Yes | Yes | Yes | Yes | — | — | — | — |
+| Veo 3.1 Fast | Yes | Yes | Yes | — | — | — | — | Yes |
+| Veo 3 | Yes | Yes | — | — | — | — | — | — |
+| Veo 3 Fast | Yes | Yes | — | — | — | — | — | Yes |
+| Sora 2 Pro | Yes | Yes | — | — | — | — | — | — |
+| Sora 2 | Yes | Yes | — | — | — | — | — | — |
+| Hailuo 2.3 | — | Yes | — | — | — | — | — | — |
+| Hailuo 2.3 Fast | — | Yes | — | — | — | — | — | — |
+| Seedance 1.0 Pro | — | Yes | Yes | — | — | — | — | — |
+| Seedance 1.0 Pro Fast | — | Yes | — | — | — | — | — | Yes |
+| Seedance 1.0 Lite | — | Yes | Yes | Yes | — | — | — | — |
+| LTX-2 Pro | Yes | Yes | — | — | — | — | — | — |
+| LTX-2 Fast | Yes | Yes | — | — | — | — | — | Yes |
+
+### Key Insight
+**Controls, Elements, and Styles are exclusive to Motion 2.0 / Motion 2.0 Fast.** All other models rely purely on prompt engineering for style and motion guidance.
+
+---
+
+## Cost Optimization Tips
+
+1. **Start with Motion 2.0 Fast** for video iteration — it's free and unlimited
+2. **Use unlimited image models** (Lucid Origin, Lucid Realism, FLUX Dev, Phoenix) when experimenting
+3. **Switch to premium only for final renders** — Veo 3.1 Fast over Veo 3.1 saves ~50% tokens
+4. **Hailuo 2.3 and LTX-2 Pro** offer the best quality-per-token for premium video
+5. **Avoid 1080p unless necessary** — 720p is usually sufficient
+6. **Generate 1 at a time** to conserve tokens while iterating

package/skills/leonardo/modules/prompt-library.md

@@ -0,0 +1,110 @@
+# Prompt Library — Curated Templates
+
+Use these as foundations and adapt to the user's specific needs. All prompts follow Leonardo.ai best practices.
+
+---
+
+## Video Prompt Templates
+
+### Cinematic / Film
+
+**Epic Establishing Shot**
+"Slow crane up over a vast mountain valley at dawn, morning mist pooling between dark pine ridges, the first golden light catching snow-capped peaks in the distance, a winding river reflects copper sky, the camera continues rising to reveal the endless landscape stretching to the horizon"
+
+**Character Introduction**
+"Dolly in toward a figure standing at the edge of a rain-soaked rooftop at night, city lights blurring into bokeh below, their coat collar turned up against the wind, neon signs reflecting in puddles at their feet, the camera pushes slowly to a medium close-up as they turn to face the lens"
+
+**Dramatic Reveal**
+"Super dolly in through a darkened corridor, light spilling from an opening ahead, dust particles floating in the beam, the camera accelerates as it reaches the threshold and bursts into a vast sunlit cathedral interior, stained glass casting prismatic light across stone columns"
+
+### Product / Commercial
+
+**Product Hero Shot**
+"Smooth orbit left around a matte black wireless speaker floating on a clean gradient background, studio rim lighting creating crisp edge highlights, subtle reflection on the surface below, the camera completes a quarter rotation revealing the speaker grille texture and LED indicator"
+
+**Lifestyle Integration**
+"Dolly right following a hand placing a ceramic coffee mug on a sunlit wooden table, steam rising from the surface catching golden morning light through linen curtains, shallow depth of field with a blurred kitchen garden visible through the window"
+
+### Nature / Landscape
+
+**Golden Hour Landscape**
+"Crane up over a field of wild lavender at sunset, wind creating rippling waves across the purple surface, a lone oak tree silhouetted against a gradient sky of amber and deep violet, fireflies beginning to emerge in the warm air, the camera rises to reveal rolling hills beyond"
+
+**Dramatic Weather**
+"Dolly in toward a lighthouse on a rocky cliff during a storm, massive waves crashing against dark basalt, spray exploding upward, the lighthouse beam cutting through sheets of rain, dark thunderclouds rolling overhead with distant lightning illuminating the churning sea"
+
+### Abstract / Artistic
+
+**Fluid Dynamics**
+"Macro dolly in on luminous ink drops falling into clear water in slow motion, magenta and gold pigment expanding in organic tendrils, light refracting through the mixing colors creating iridescent patterns, the camera pushes through the microscopic landscape of swirling fluid"
+
+**Geometric Transformation**
+"Orbit right around a cluster of floating metallic polyhedra catching studio light, each surface reflecting a different color, the shapes slowly rotate and reconfigure into new arrangements, sharp geometric edges creating precise shadow patterns on a matte white background"
+
+### Social Media / Short Form
+
+**Trending Hook**
+"Crash zoom in on a pair of hands unboxing a glossy product from minimalist packaging, tissue paper crinkling, the item emerges catching direct light, camera settles into a tight detail shot revealing the texture and craftsmanship, clean white background with soft shadows"
+
+**Satisfying Loop**
+"Top-down dolly in on a precise pour of thick caramel over a chocolate dessert, the golden liquid flowing in smooth ribbons, coating the surface and pooling at the edges, macro detail showing tiny air bubbles and glossy reflection, warm studio lighting"
+
+---
+
+## Image Prompt Templates
+
+### Portrait / People
+
+**Editorial Portrait**
+"Editorial portrait of a woman in her 30s with natural curly hair, wearing a charcoal linen blazer against a blurred urban backdrop, shot at 85mm f/1.4 with soft window light from the left creating gentle catchlights, muted warm tones with shallow depth of field"
+
+**Character Concept**
+"Full-body character concept art of a cyberpunk street vendor, wearing a weathered leather jacket covered in holographic patches, neon-blue circuit tattoos visible on their neck, standing in a rain-slicked alley with steam vents, painted in a detailed digital art style with strong rim lighting"
+
+### Landscape / Architecture
+
+**Architectural Photography**
+"Interior of a minimalist concrete art gallery, double-height ceiling with a single rectangular skylight casting a blade of warm light across polished concrete floor, a single large-scale painting on the far wall, shot at 24mm with leading lines drawing the eye inward, muted gray and warm amber"
+
+**Fantasy Landscape**
+"Towering Gothic castle carved into a sea cliff face, waves crashing against dark volcanic rock below, twilight sky with scattered cirrus clouds catching the last amber light, ravens circling the highest tower, painted in the style of detailed fantasy concept art, deep blues and warm amber highlights"
+
+### Product
+
+**E-commerce Product Shot**
+"Pair of white minimalist sneakers on a clean light gray background, shot from 3/4 angle showing sole detail and stitching, crisp studio lighting with soft shadows, commercial photography style, neutral tones with bright white product pop"
+
+**Flat Lay**
+"Overhead flat lay of a curated workspace: leather-bound notebook, brass pen, ceramic espresso cup, succulent plant, and vintage brass compass arranged on weathered oak desk surface, soft diffused natural light from above, warm earth tones"
+
+### Logo / Design
+
+**Modern Logo**
+"Minimalist geometric logo design for a tech company, abstract interlocking shapes forming a stylized 'N', clean lines on white background, gradient from deep navy to electric blue, scalable vector aesthetic"
+
+**App Icon**
+"Rounded square app icon design, abstract sound wave visualization in gradient teal and purple, dark background, subtle glass reflection overlay, iOS design language, clean and recognizable at small sizes"
+
+### Illustration / Art
+
+**Fantasy Art**
+"Digital painting of a solitary astronaut standing on the surface of an alien world, a massive ringed planet dominating the sky above, bioluminescent flora glowing in soft greens and blues across the rocky terrain, painted with visible brushstrokes in the style of classic sci-fi illustration"
+
+**Sci-Fi Concept**
+"Interior of a derelict space station corridor, emergency lighting casting red-orange pools on the floor, overgrown with alien vegetation breaking through wall panels, a single shaft of white light from a hull breach, detailed concept art style with strong atmosphere and narrative tension"
+
+---
+
+## Negative Prompt Templates
+
+### For Photorealistic Images
+"blurry, low quality, deformed, distorted, extra limbs, extra fingers, disfigured, bad anatomy, text, watermark, signature, cropped, out of frame, worst quality, jpeg artifacts"
+
+### For Illustration / Art
+"photographic, hyperrealistic, 3D render, stock photo, generic, clipart, low effort, blurry, text, watermark"
+
+### For Video (General)
+"blurry, low quality, distorted faces, text overlay, watermark, static image, frozen frame, glitch artifacts, unnatural motion, jittery, flickering"
+
+### For Product Shots
+"busy background, harsh shadows, unwanted reflections, text, hands, people, cluttered, low resolution, color cast"

package/skills/leonardo/modules/style-guide.md

@@ -0,0 +1,186 @@
+# Style Guide — Reference
+
+Complete reference for Leonardo.ai styles, lighting, and visual options. Use this to make informed selections during the prompter questionnaires.
+
+---
+
+## Image Style Presets — When to Use Each
+
+| Style | Best For | Description |
+|-------|----------|-------------|
+| Dynamic | General purpose, action | Balanced enhancement, good for most subjects |
+| Cinematic | Moody, dramatic, film-like | Adds depth, dramatic lighting, film grain |
+| Creative | Art, illustration, experimental | Painterly, artistic interpretation |
+| Vibrant | Social media, marketing | Bold saturated colors, eye-catching |
+| Portrait | Headshots, people, faces | Optimized skin tones, soft focus |
+| Fashion | Editorial, high-fashion | Stylized lighting, fashion photography look |
+| Stock Photo | Commercial, corporate | Clean, professional, stock photography |
+| None | Full prompt control | No style modification — pure prompt |
+
+**Guideline:** Use "None" when your prompt is already highly specific about style. Use "Dynamic" as a safe default. Use "Cinematic" for anything moody or dramatic.
+
+---
+
+## Video Style Stacking — Three-Layer System
+
+Video styles stack in three layers. Pick one from each (or skip any). Only works with **Motion 2.0** and **Motion 2.0 Fast**.
+
+### Vibe Layer (overall aesthetic)
+| Vibe | Use When |
+|------|----------|
+| Pro Photo | Professional, polished look. Product videos, corporate |
+| Stock Footage | Documentary feel, natural. Nature, travel |
+| Sci-Fi | Futuristic, technological. Neon, holographic, cyber |
+| Sketch | Hand-drawn, animated feel. Whimsical, explainer |
+| Clay | Stop-motion, tactile. Playful, craft aesthetic |
+| Color Sketch | Illustrated with color. Storyboard, artistic |
+| Logo | Motion graphics, branding. Logo reveals, intros |
+| Papercraft | Paper cutout, collage. Children's content, craft |
+| None | Let other layers dominate |
+
+### Lighting Layer (how light behaves)
+| Lighting | Use When | Mood |
+|----------|----------|------|
+| Golden Hour | Warm, romantic, natural. Outdoors, sunset | Warm, nostalgic |
+| Chiaroscuro | Dramatic contrast, cinematic | Intense, dramatic |
+| Volumetric | Atmospheric fog, rays of light | Mysterious, ethereal |
+| Lens Flare | Stylized, energetic, music video | Dynamic, glamorous |
+| Backlight | Subject silhouette, halo effect | Dramatic, dreamy |
+| Candle Lit | Intimate, warm, flickering | Romantic, cozy |
+| Film Haze | Soft diffusion, vintage film look | Nostalgic, dreamy |
+| Foggy | Atmosphere, depth, mystery | Eerie, contemplative |
+| Hardlight | Sharp shadows, high contrast | Bold, edgy |
+| Light Art | Neon, light painting effects | Creative, nightlife |
+| Low Key | Dark, moody, minimal light | Suspenseful, noir |
+| Luminous | Glowing, radiant, ethereal | Magical, uplifting |
+| Mystical | Supernatural glow, fantasy | Enchanted, otherworldly |
+| Rainy | Wet surfaces, reflections | Melancholic, moody |
+| Soft Light | Even, gentle illumination | Calm, approachable |
+
+### Color Theme Layer (palette)
+| Color | Use When | Feel |
+|-------|----------|------|
+| Warm | Golden, amber, cozy scenes | Comfortable, inviting |
+| Cool | Blue, teal, clinical, tech | Professional, calm |
+| Vibrant | High saturation, eye-catching | Energetic, playful |
+| Dark | Low-key, shadows dominant | Mysterious, intense |
+| Autumn | Orange, brown, seasonal | Nostalgic, rustic |
+| Earthy | Natural greens, browns, tans | Organic, grounded |
+| Electric | Neon, high-contrast color | Exciting, modern |
+| Iridescent | Shifting, rainbow, holographic | Futuristic, magical |
+| Pastel | Soft muted colors | Gentle, feminine, clean |
+| Complimentary | Opposing color harmony | Balanced, artistic |
+| Split | Split-complementary palette | Nuanced, sophisticated |
+| Terracotta Teal | Warm earth + cool water tones | Trendy, balanced |
+| Ultraviolet | Purple-dominated, UV glow | Cosmic, nocturnal |
+
+---
+
+## Recommended Style Combos
+
+| Desired Look | Vibe | Lighting | Color | Notes |
+|-------------|------|----------|-------|-------|
+| Hollywood blockbuster | Pro Photo | Chiaroscuro | Warm | Classic cinematic |
+| Cyberpunk | Sci-Fi | Volumetric | Dark | Add neon in prompt |
+| Product commercial | Pro Photo | Soft Light | Vibrant | Clean, professional |
+| Music video | — | Lens Flare | Electric | High energy |
+| Nature documentary | Stock Footage | Golden Hour | Earthy | Natural, immersive |
+| Horror/Thriller | — | Low Key | Dark | Tension, shadows |
+| Vintage film | — | Film Haze | Autumn | Nostalgic warmth |
+| Corporate/Tech | Pro Photo | Soft Light | Cool | Professional, clean |
+| Dreamy/Ethereal | — | Luminous | Iridescent | Magical glow |
+| Social media (bright) | — | Backlight | Vibrant | Attention-grabbing |
+| Noir | — | Chiaroscuro | Dark | Classic film noir |
+| Fantasy/Magic | — | Mystical | Iridescent | Enchanted worlds |
+| Stop-motion | Clay | Soft Light | Warm | Craft aesthetic |
+| Sketch animation | Sketch | — | Pastel | Hand-drawn feel |
+| Logo reveal | Logo | — | Electric | Brand intros |
+
+---
+
+## Motion Controls — Cinematic Language
+
+### Camera Movement Controls
+| Control | Cinematic Use | Emotional Effect |
+|---------|--------------|-----------------|
+| Dolly In | Push toward subject | Builds intimacy, focus |
+| Dolly Out | Pull away from subject | Creates distance, reveals context |
+| Dolly Left/Right | Lateral tracking | Following motion, exploration |
+| Crane Up | Rising shot | Revelation, grandeur, power |
+| Crane Down | Descending shot | Arrival, settling, intimacy |
+| Crane Over Head | Overhead sweep | God's-eye view, scope |
+| Tilt Up | Camera tilts upward | Awe, discovery, scale |
+| Tilt Down | Camera tilts downward | Focus, descent, detail |
+| Orbit Left/Right | Circles subject | Showcase, examination, drama |
+| Rotate | Spins the frame | Disorientation, energy |
+| Dutch Angle | Tilted frame | Unease, tension, dynamic |
+| Snorricam | Fixed to subject's body | Intensity, vertigo |
+| Robo Arm | Mechanical, precise moves | Technical, industrial |
+| Lazy Susan | Slow rotation of scene | Dreamlike, display |
+
+### Zoom Controls
+| Control | Use | Effect |
+|---------|-----|--------|
+| Crash Zoom In | Sudden focus | Shock, emphasis, comedy |
+| Crash Zoom Out | Sudden reveal | Surprise, context shift |
+| Medium Zoom In | Moderate push | Gentle focus |
+| Super Dolly In | Extreme forward push | Powerful drive, intensity |
+| Super Dolly Out | Extreme pullback | Grand reveal |
+| YoYo Zoom | In-out oscillation | Playful, hypnotic |
+| Bullet Time | Frozen moment, rotating | Iconic, dramatic |
+
+### Special FX Controls
+| Control | Use | Effect |
+|---------|-----|--------|
+| Explosion | Destructive reveal | Impact, action |
+| Disintegration | Breaking apart | Transformation, decay |
+| Freezing | Ice crystallization | Cold, preservation |
+| Flood | Water rising | Danger, overwhelming |
+| Set on Fire | Combustion | Passion, destruction |
+| Thunder God | Lightning effects | Power, divine |
+| Night | Day-to-night transition | Time, mood shift |
+| Metal | Metallic transformation | Industrial, tough |
+| Light Morph | Light-based transformation | Magical, transition |
+| Ripple Morph | Liquid distortion | Dreamy, surreal |
+| Lens Crack | Glass breaking | Breaking barriers |
+| Touch Glass | Press against glass | Intimate, trapped |
+| Tattoo Motion | Ink coming alive | Creative, body art |
+| Handheld | Natural camera shake | Documentary, raw |
+| Eyes In | Zoom into eyes | Soul, emotion |
+| Mouth In | Zoom into mouth | Speech, consumption |
+
+---
+
+## Motion Elements — Creative Overlays
+
+These apply an artistic filter to the entire video. Best used when you want a specific visual style that goes beyond what prompting alone achieves.
+
+| Element | Aesthetic | Best For |
+|---------|-----------|----------|
+| Golden Age Cinema | Classic Hollywood | Period pieces, nostalgia |
+| Moody Realism | Gritty, atmospheric | Drama, documentary |
+| CGI Noir | Dark, computer-generated | Thriller, mystery |
+| Editorial Blur | Selective focus, fashion | Commercial, portrait |
+| Simple Flat Animation | Clean 2D motion | Explainers, kids content |
+| Claynimation | Stop-motion clay | Playful, craft |
+| Stylized 3Dtoon | 3D cartoon render | Animation, gaming |
+| Whimsy Animation | Playful, magical | Children's, fantasy |
+| Old VHS | Degraded video tape | Retro, horror |
+| 90s Retro Anime | Classic anime style | Anime fans, nostalgia |
+| Vintage Black & White | Classic monochrome | Artistic, period |
+| Y2K Analog | Early 2000s aesthetic | Trendy, nostalgia |
+| Sunny Nostalgia | Warm, golden memories | Lifestyle, feel-good |
+| Watercolor | Painted, flowing | Art, dreamy |
+| Digital Painting | Painted, detailed | Concept art, fantasy |
+| Inkflow | Ink spreading, organic | Artistic, calligraphy |
+| Pixel Art | 8-bit, retro gaming | Gaming, retro |
+| Retro Line Art | Clean line drawing | Technical, minimalist |
+| Dreamcore | Surreal, liminal | Experimental, eerie |
+| Glowwave | Neon glow, synthwave | Music, nightlife |
+| Synthwave | 80s retro-futurism | Music, retro |
+| Dark Fantasy | Gothic, dark magic | Fantasy, horror |
+| Soft Infrared | Heat-map-like, ethereal | Experimental, sci-fi |
+| Quiet Blue Hour | Pre-dawn blue tones | Calm, contemplative |
+| Felted | Felt fabric texture | Craft, cozy |
+| Silver Hue Analog | Silver-toned film | Classic, elegant |
+| Oldschool Comic | Comic book panels | Comics, pop art |