@hienlh/ppm 0.9.79 → 0.9.81

package/.opencode/skills/video/references/veo-prompt-guide.md

@@ -0,0 +1,360 @@
+# Veo 3.1 Prompt Engineering Guide
+
+Comprehensive guide for crafting effective Veo 3.1 prompts for marketing video generation.
+
+## Prompt Structure
+
+```
+[SUBJECT] + [ACTION] + [SETTING] + [STYLE] + [CAMERA] + [LIGHTING] + [MOTION] + [AUDIO] + [CONSTRAINTS]
+```
+
+### Components
+
+| Component | Description | Example |
+|-----------|-------------|---------|
+| Subject | Main focus | "A young professional in business casual" |
+| Action | What happens | "types on laptop, then looks up smiling" |
+| Setting | Environment | "modern co-working space with plants" |
+| Style | Visual treatment | "clean, minimalist, corporate aesthetic" |
+| Camera | Shot type/movement | "medium close-up, slight dolly in" |
+| Lighting | Light setup | "soft natural window light" |
+| Motion | Movement quality | "smooth, steady, professional" |
+| Audio | Sound elements | "ambient office sounds, soft typing" |
+| Constraints | Technical specs | "8 seconds, 1080p, 16:9" |
+
+## Marketing Video Prompt Templates
+
+### Product Demo
+
+```
+Marketing video clip for {brand}:
+
+Visual: {product} in use by {user_type} in {setting}
+Action: {demonstration_action}, then {result_shown}
+Style: Professional, polished, {brand_adjectives}
+Camera: {shot_type}, {camera_movement}
+Lighting: {lighting_setup}
+
+Audio:
+- "{speaker}" says: "{dialogue}"
+- SFX: {sound_effect} as {action_trigger}
+- Music: Subtle {genre} background
+
+Technical: 8 seconds, {aspect_ratio}, high quality, professional grade
+```
+
+### Social Short-Form
+
+```
+Trending TikTok/Reels style video:
+
+Visual: {eye_catching_scene}
+Action: {quick_action_sequence}
+Style: Vibrant, energetic, Gen-Z aesthetic
+Camera: Dynamic angles, quick cuts implied
+Pacing: Fast, attention-grabbing
+
+Audio:
+- SFX: {trending_sound}
+- Music: {trending_music_style}
+
+Technical: 8 seconds, 9:16 vertical, mobile-optimized
+```
+
+### Explainer Animation
+
+```
+Educational explainer video:
+
+Visual: {concept_visualization}
+Action: {step_by_step_reveal}
+Style: Clean, informative, {brand_colors}
+Camera: Static with subtle zoom
+Graphics: Text overlays, icons animating in
+
+Audio:
+- Voiceover: "{explanation}"
+- Music: Light, upbeat background
+
+Technical: 8 seconds, 16:9, 1080p
+```
+
+### Testimonial Style
+
+```
+Customer testimonial video:
+
+Visual: {person_description} in {authentic_setting}
+Action: Speaking directly to camera, natural gestures
+Style: Authentic, relatable, warm
+Camera: Medium shot, steady, eye-level
+Lighting: Natural, flattering
+
+Audio:
+- "{customer}" says: "{testimonial_quote}"
+- Ambient: Natural room tone
+
+Technical: 8 seconds, 16:9, 1080p
+```
+
+## Audio Directives
+
+### Dialogue Format
+
+```
+"{Speaker name}" says: "{Exact quote here}"
+```
+
+**Rules:**
+- Speaker name in quotes
+- Dialogue in separate quotes
+- Keep under 20 words per 8 seconds
+- Clear, natural pacing
+
+**Examples:**
+```
+"Sarah" says: "This changed everything for our team"
+"Narrator" says: "Introducing the future of productivity"
+```
+
+### Sound Effects (SFX)
+
+```
+SFX: {description} as {action_trigger}
+```
+
+**Examples:**
+```
+SFX: Satisfying click as button is pressed
+SFX: Whoosh sound as product slides into frame
+SFX: Notification ping when message arrives
+SFX: Soft pop as feature appears
+```
+
+### Ambience
+
+```
+Ambient: {2-3 elements max}
+```
+
+**Examples:**
+```
+Ambient: Busy coffee shop murmur, espresso machine
+Ambient: Office typing, distant phone rings
+Ambient: Wind through trees, birdsong
+```
+
+### Music
+
+```
+Music: {genre/mood}, subtle
+```
+
+**Examples:**
+```
+Music: Upbeat corporate, subtle background
+Music: Inspiring orchestral, building
+Music: Lo-fi hip hop, relaxed
+Music: Electronic pop, energetic
+```
+
+## Quality Phrases
+
+### Professional Quality
+
+- "crystal clear dialogue"
+- "professional audio mixing"
+- "balanced audio levels"
+- "synchronized dialogue and action"
+- "broadcast quality"
+- "cinematic grade"
+
+### Visual Quality
+
+- "high production value"
+- "professional lighting"
+- "clean composition"
+- "sharp focus"
+- "smooth motion"
+- "polished aesthetic"
+
+## Camera Movements
+
+| Movement | When to Use |
+|----------|-------------|
+| Static | Testimonials, talking head |
+| Dolly in | Building emotion, focus |
+| Dolly out | Reveal, context |
+| Pan | Following action, scanning |
+| Tilt | Vertical reveal |
+| Orbit | Product showcase |
+| Tracking | Following subject |
+
+**Format:**
+```
+Camera: {shot_type}, {movement}, {speed}
+```
+
+## Shot Types
+
+| Shot | Best For |
+|------|----------|
+| Extreme close-up | Details, emotion |
+| Close-up | Products, faces |
+| Medium | Conversations, demos |
+| Wide | Environment, context |
+| Aerial | Scale, establishing |
+
+## Timing Control
+
+### Explicit Timing
+
+```
+0-2s: [Scene setup and hook]
+2-4s: [Main action develops]
+4-6s: [Key moment/reveal]
+6-8s: [Resolution and CTA]
+```
+
+### Pacing Descriptors
+
+- "Slow, contemplative pace"
+- "Quick cuts, energetic"
+- "Steady, professional rhythm"
+- "Building momentum"
+
+## Common Mistakes to Avoid
+
+### Prompt Issues
+
+| Don't | Do |
+|-------|---|
+| Vague subjects | Specific descriptions |
+| Multiple complex actions | Single clear action |
+| Conflicting styles | Consistent aesthetic |
+| Technical jargon | Natural language |
+| Too much dialogue | Brief, impactful speech |
+
+### Audio Mistakes
+
+- More than 3 ambient elements
+- Dialogue over 20 words
+- Conflicting audio layers
+- Unrealistic sound expectations
+
+## Platform-Specific Adjustments
+
+### YouTube (16:9)
+
+```
+Style: High production value, professional
+Pacing: Can be more measured
+Audio: Full range, detailed
+```
+
+### TikTok/Reels (9:16)
+
+```
+Style: Trendy, eye-catching, native feel
+Pacing: Fast, hook immediately
+Audio: Trending sounds, music-forward
+```
+
+### LinkedIn (16:9)
+
+```
+Style: Professional, corporate-friendly
+Pacing: Measured, informative
+Audio: Clear speech, subtle music
+```
+
+## Example Prompts by Type
+
+### Product Launch
+
+```
+Marketing video for TechCorp:
+
+Visual: Sleek smartphone rotating on minimalist pedestal, premium materials visible
+Action: Phone lights up, app opens, feature demonstrated
+Setting: Clean white studio with subtle gradient
+Style: Apple-inspired, premium, aspirational
+Camera: Slow orbit around product, then close-up detail shot
+Lighting: Soft studio lighting, product highlights
+
+Audio:
+- "Narrator" says: "Meet the future"
+- SFX: Satisfying click as screen activates
+- Music: Modern electronic, building anticipation
+
+Technical: 8 seconds, 16:9, 1080p, high quality
+```
+
+### SaaS Demo
+
+```
+Software demonstration video:
+
+Visual: Dashboard on large monitor, data visualizing
+Action: User clicks through interface, charts animate
+Setting: Modern office, dual monitors
+Style: Professional, tech-forward, clean UI focus
+Camera: Over-shoulder shot, then UI close-up
+Lighting: Balanced office lighting, no screen glare
+
+Audio:
+- "Sarah" says: "Watch how easy this is"
+- SFX: Soft clicks, notification sounds
+- Music: Light corporate background
+
+Technical: 8 seconds, 16:9, 1080p
+```
+
+### Social Proof
+
+```
+Customer success story:
+
+Visual: Happy business owner in their shop, genuine smile
+Action: Gestures while speaking, shows result on tablet
+Setting: Authentic small business environment
+Style: Warm, relatable, documentary feel
+Camera: Medium shot, slight movement for life
+Lighting: Natural, flattering daylight
+
+Audio:
+- "Marcus" says: "Our sales doubled in three months"
+- Ambient: Light shop ambiance
+- Music: Inspiring, subtle
+
+Technical: 8 seconds, 16:9, 1080p
+```
+
+## Iteration Strategy
+
+### If Quality Issues
+
+1. Simplify prompt (fewer elements)
+2. Make subject more specific
+3. Reduce audio complexity
+4. Use established camera moves
+
+### If Audio Sync Issues
+
+1. Shorten dialogue
+2. Reduce simultaneous audio layers
+3. Add explicit timing markers
+4. Fall back to music-only track
+
+### If Style Inconsistent
+
+1. Add more style descriptors
+2. Reference specific aesthetics
+3. Use consistent lighting terms
+4. Maintain single mood throughout
+
+## Resources
+
+- [Veo API Documentation](https://ai.google.dev/gemini-api/docs/video)
+- [Video Generation Guide](https://ai.google.dev/gemini-api/docs/video#model-versions)
+- [AI Multimodal Skill](../../ai-multimodal/SKILL.md)

package/.opencode/skills/video/references/video-art-directions.md

@@ -0,0 +1,64 @@
+# Video Art Directions (Top 50)
+
+| Style category | Core keywords (copy-paste ready) | Color Palette | Ideas | Signature Effects & Details | Background music description | Voice over style | Purposes |
+|---|---|---|---|---|---|---|---|
+| Minimalist Product Studio | minimalist, clean, negative space, studio, pristine, premium, focus, macro | White, soft gray, black accents (#FFFFFF #F3F4F6 #111827) | Product floating shots, slow 360, macro material reveals | Seamless cyclorama, softbox gradients, subtle shadow falloff, dust-free highlights | Sparse ambient + light ticks, modern minimal | Calm, confident, few words, precise | Product hero, ecommerce, premium launches |
+| High-Key Lifestyle Bright | high-key, airy, optimistic, natural light, daytime, smiles, candid | Cream, sky blue, warm sand (#FFF7ED #93C5FD #FDE68A) | Bright home morning routine, family moments, handheld warmth | Overexposed window bloom, soft diffusion, gentle handheld | Uplifting indie pop, claps, light percussion | Friendly, conversational, energetic | DTC lifestyle, wellness, family brands |
+| Dark Moody Chiaroscuro | moody, low-key, dramatic, chiaroscuro, contrast, textured, cinematic | Charcoal, deep brown, warm tungsten (#0B0F19 #2A1E17 #F59E0B) | Craftsmanship close-ups, hands at work, luxury reveal from darkness | Hard key + negative fill, smoke haze, specular roll-off | Minimal dark ambient, sub-bass pulses, slow tempo | Intimate, gravelly, deliberate | Luxury, spirits, premium fashion, craftsmanship |
+| Luxury Black & Gold | luxury, opulent, black, gold, sparkle, premium, iconic | Black, gold, ivory (#000000 #D4AF37 #FAF7F2) | Jewelry/drinks hero with gold reflections, slow elegance | Gold bokeh, prism flares, silk fabric ripples, glossy reflections | Elegant orchestral + modern trap hats | Polished, authoritative, aspirational | High-end launches, prestige branding |
+| Scandinavian Hygge | scandi, hygge, cozy, natural wood, soft, neutral, calm | Off-white, oat, sage (#FAFAF9 #E7D7C1 #A7C4B5) | Cozy home scenes, knit textures, tea/coffee rituals | Soft diffusion, gentle grain, shallow DOF, warm practicals | Warm lo-fi, acoustic guitar, vinyl crackle | Soft, warm, reassuring | Home goods, lifestyle, wellness, interiors |
+| Modern Tech Futurism | futuristic, sleek, tech, glass, steel, precision, innovation, UI | Cool gray, cyan, electric blue (#E5E7EB #22D3EE #2563EB) | Product in clean lab, UI overlays, data visuals | Motion-tracked HUD, parallax screens, micro-glows, scan lines | Pulsing synth, arps, clean electronic | Clear, assured, slightly excited | SaaS, hardware, product demos, innovation |
+| Cyberpunk Neon Night | cyberpunk, neon, rain, night city, hologram, gritty, electric | Magenta, cyan, deep navy (#FF2D95 #00E5FF #0A1026) | Street-level city chase, neon signage, reflective pavement | Neon bloom, chromatic aberration, rain FX, animated signage | Driving synthwave, 80s bass, punchy drums | Edgy, fast, street-smart | Gaming, youth brands, nightlife, launches |
+| Retro 80s Synthwave | synthwave, 80s, grid, chrome, sunset, nostalgic, arcade | Hot pink, purple, sunset orange (#FF3EA5 #7C3AED #FB923C) | Retro product reveal with grid horizon, chrome logo | Film grain, VHS glow, light streaks, neon outlines | Classic synthwave, gated reverb snare | Playful, confident, punchy slogans | Entertainment, merch drops, event promos |
+| 90s VHS Home Video | VHS, 90s, camcorder, raw, nostalgic, lo-fi, tape | Washed teal, magenta tint, off-white (#6EE7B7 #F472B6 #F5F5F4) | “Found footage” brand story, real moments, diary style | Timecode overlay, tracking noise, tape warble, handheld zoom | Lo-fi hip hop, cassette hiss | Casual, authentic, imperfectly perfect | Community, creator brands, nostalgic campaigns |
+| 16mm Film Indie | 16mm, film, grain, handheld, natural light, authentic, indie | Warm neutrals, olive, sun flare (#FDE68A #6B7280 #84CC16) | Road trip story, candid portraits, documentary vibes | Gate weave, film grain, halation, lens flares | Indie folk, minimal drums, airy pads | Thoughtful, human, story-first | Brand films, mission, values, recruitment |
+| Film Noir | noir, monochrome, shadows, mystery, rain, detective, vintage | Black, white, smoke gray (#000000 #FFFFFF #6B7280) | Mystery narrative, silhouettes, voice-over confession | Venetian blind shadows, cigarette smoke, hard rim light | Jazz noir, upright bass, brushed snare | Classic, witty, dramatic | Teasers, storytelling ads, fashion, luxury |
+| Editorial Fashion Gloss | editorial, fashion, runway, glossy, high-contrast, attitude, bold | Black, white, accent red (#0B0B0B #F5F5F5 #EF4444) | Pose-driven cuts, whip pans, typography statements | Beauty lighting, high shutter, flash pops, graphic titles | Minimal electro, high-fashion beats | Cool, concise, commanding | Fashion drops, lookbooks, premium branding |
+| Natural Documentary | documentary, vérité, real, candid, handheld, observational, truthful | True-to-life, soft contrast, natural skin tones | Real customers, unscripted moments, day-in-the-life | Handheld imperfections, ambient sound, minimal grading | Organic ambient + subtle piano | Honest, empathetic, conversational | Testimonials, mission, social impact |
+| UGC Creator Native | UGC, selfie, vertical, casual, relatable, authentic, quick cuts | Vibrant but natural, warm indoor (#FDE68A #FB7185 #60A5FA) | Creator unboxing, quick tips, “3 reasons” format | Jump cuts, captions, stickers, on-screen callouts | Trendy pop/hip hop, short hooks | Energetic, friendly, direct-to-camera | Performance ads, TikTok/Reels, DTC |
+| Clean Corporate Premium | corporate, premium, professional, polished, executive, credible | Navy, white, light gray (#0F172A #FFFFFF #E5E7EB) | CEO message, office B-roll, product + team montage | Smooth gimbal, subtle lower-thirds, clean typography | Modern corporate bed, soft percussion | Confident, measured, trustworthy | B2B, investor, recruitment, brand trust |
+| Startup Kinetic Typography | kinetic typography, punchy, fast, bold, motion design, dynamic | Black/white + neon accent (#0B0F19 #FFFFFF #A3E635) | Text-led storytelling with minimal footage, bold claims | Text wipes, beat-synced transitions, icon pops | Upbeat electronic, tight kick/snare | Fast, persuasive, rhythmic | Explainers, SaaS landing, app promos |
+| Pastel Kawaii Cute | kawaii, cute, pastel, playful, bubbly, rounded, stickers | Pastel pink, lavender, mint (#FBCFE8 #DDD6FE #BBF7D0) | Character mascots, playful product usage, “pop” moments | Sticker overlays, sparkle bursts, soft blur, bounce easing | Cute pop, glockenspiel, light beats | Cheerful, bright, youthful | Youth, snacks, beauty, apps |
+| Bold Pop Art | pop art, comic, halftone, bold, graphic, punch, fun | Primary red/yellow/blue (#EF4444 #FACC15 #3B82F6) | Comic panels telling the offer, punchlines, visual puns | Halftone texture, speech bubbles, thick outlines | Funky upbeat, brass stabs | Animated, enthusiastic, comedic | Promotions, retail, social campaigns |
+| Surreal Dreamscape | surreal, dream, floating, uncanny, poetic, slow, abstract | Deep blue, violet, pearl (#0EA5E9 #8B5CF6 #F8FAFC) | Impossible spaces, floating products, metaphor visuals | Slow-motion, particle drift, match cuts, morphs | Ambient cinematic pads, ethereal textures | Whispery, poetic, minimal | Brand film, premium storytelling, awareness |
+| Hyperreal Macro | macro, hyperreal, texture, droplets, crisp, satisfying, ASMR | Vivid primaries + clean neutrals (#111827 #22C55E #F97316) | Extreme close-ups: fizz, crunch, skin, fabric, metal | High-speed, macro rails, micro-shallow DOF, crisp sound design | Minimal music + detailed foley/ASMR | Low, intimate, sensory-focused | Food/beauty/product detail, premium ads |
+| Food Porn Slo-Mo | food, delicious, glossy, slow motion, steam, drizzle, sizzle | Warm reds, browns, golden highlights (#7C2D12 #DC2626 #F59E0B) | Pour shots, sizzles, knife cuts, hero plating | Steam/haze, high-speed, light wrap, sauce trails | Groovy modern funk, tasteful bounce | Mouth-watering, playful, descriptive | Restaurants, CPG, delivery apps |
+| Wellness Zen Spa | zen, calm, spa, mindful, soft, breath, minimal, nature | Soft beige, seafoam, stone gray (#F5F5F4 #A7F3D0 #9CA3AF) | Slow rituals, skincare, water, breath-led pacing | Soft diffusion, slow push-ins, gentle water ripples | Ambient + singing bowls, slow pads | Gentle, soothing, guided | Wellness, skincare, meditation, retreats |
+| Adventure Outdoor Epic | outdoor, adventure, epic, mountain, trail, freedom, wide | Deep green, sky blue, earth (#14532D #60A5FA #A16207) | Summit moments, running trails, wide drone reveals | Wide anamorphic look, wind audio, sun flares, speed ramps | Cinematic drums + uplifting strings | Inspirational, big-vision | Sports, travel, lifestyle, brand anthems |
+| Sports High-Performance | sports, grit, intensity, sweat, speed, power, training | Black, red, steel gray (#0B0F19 #EF4444 #9CA3AF) | Training montage, explosive cuts, “beat the clock” | Speed ramps, strobe cuts, punchy impacts, sweat highlights | Aggressive trap/rock hybrid, heavy hits | Motivational, commanding, rapid | Fitness, apparel, equipment, promos |
+| Clean Beauty Soft Glow | beauty, soft glow, luminous, skincare, gentle, feminine, airy | Blush, champagne, pearl (#FCE7F3 #FDE68A #F8FAFC) | Skin close-ups, gentle application, “before/after” | Soft key + bounce, subtle bloom, clean backgrounds | Light modern pop, soft plucks | Warm, reassuring, expert | Skincare, cosmetics, personal care |
+| Clinical Science White Lab | clinical, science, lab, sterile, evidence, dermatologist, tested | White, cool blue, mint (#FFFFFF #1D4ED8 #A7F3D0) | Lab scenes, ingredient callouts, efficacy proof | Clean overlays, diagrams, macro molecules, sterile set | Clean electronic + subtle pulses | Expert, precise, credible | Healthcare, skincare science, supplements |
+| Eco-Natural Earthy | eco, natural, sustainable, handmade, organic, earthy, ethical | Earth brown, leaf green, cream (#92400E #16A34A #FFFBEB) | Farm-to-shelf, recycled materials, nature details | Natural textures, grain, sun flare, imperfect edges | Acoustic + nature ambience (birds/wind) | Honest, values-driven | Sustainability messaging, brand trust |
+| Rustic Craft Artisan | artisan, handmade, workshop, tactile, craft, heritage, slow | Walnut, brass, linen (#5B3A29 #B45309 #F5F5F4) | Hands crafting, tools, process storytelling | Close-up tool sounds, warm tungsten, dust motes | Americana/folk, steady rhythm | Storyteller, warm, proud | Craft brands, premium goods, origin stories |
+| Urban Street Grit | street, gritty, urban, handheld, graffiti, raw, hustle | Concrete gray, neon accent (#374151 #111827 #22D3EE) | Street scenes, quick cuts, real people, edge | Handheld shake, light leaks, gritty texture, overlays | Hip hop beat, gritty bass | Direct, confident, attitude | Streetwear, youth, events, culture |
+| Elegant Romantic Soft Focus | romantic, soft focus, poetic, warm, intimate, gentle | Rose, cream, warm gold (#FB7185 #FFF7ED #F59E0B) | Couples moments, slow embraces, candlelit scenes | Pro-mist diffusion, bokeh, slow motion, warm practicals | Piano + soft strings, slow tempo | Tender, heartfelt | Jewelry, fragrance, weddings, premium gifts |
+| Bright Kids Educational | kids, colorful, educational, friendly, playful, simple, clear | Bright primary + teal (#EF4444 #FACC15 #3B82F6 #14B8A6) | Simple demos, friendly characters, clear steps | Simple animations, big icons, bouncy transitions | Happy ukulele/pop, simple melodies | Upbeat, clear, encouraging | Edtech, toys, family products |
+| Motion Graphics Explainer | explainer, icons, diagrams, clean, 2D, friendly, simple | Brand colors + neutrals (#111827 #F8FAFC + brand) | Problem/solution arc, feature breakdown, flow charts | Smooth easing, icon morphs, clean transitions | Light corporate pop, steady groove | Clear, structured, confident | SaaS explainers, onboarding, product updates |
+| 3D Product Visualization | 3D, CGI, render, glossy, precision, impossible angles, clean | Cool neutral + accent (#0B0F19 #E5E7EB #38BDF8) | Cutaway internals, exploded view, material transitions | Perfect reflections, depth fog, micro-detail shaders | Futuristic synth + sub bass | Technical, assured, premium | Hardware, automotive, tech demos |
+| Automotive Cinematic | automotive, cinematic, road, premium, speed, reflections, night | Deep black, silver, cool blue (#0B0F19 #9CA3AF #2563EB) | Car hero passes, interior luxury, road curves | Light streaks, polarizer reflections, low angles | Driving cinematic, pulsing rhythm | Confident, cool, aspirational | Auto, mobility, premium products |
+| Coastal Summer Sun-Kissed | summer, beach, sun-kissed, carefree, bright, salt, breeze | Aqua, coral, sandy beige (#22D3EE #FB7185 #FDE68A) | Beach days, surf, outdoor hang, carefree smiles | Sun flare, warm grade, water sparkle, wind movement | Tropical pop, light percussion | Fun, breezy, friendly | Travel, beverages, lifestyle, seasonal |
+| Winter Minimal Cool | winter, crisp, clean, cool, snow, breath, minimal | Ice blue, white, slate (#E0F2FE #FFFFFF #334155) | Cold product refresh, outdoor winter scenes | Cool grade, breath vapor, subtle snow particles | Ambient + soft bells, minimal | Clear, calm, refreshing | Winter campaigns, skincare, apparel |
+| Horror Teaser (Tasteful) | suspense, eerie, tension, shadows, build, unsettling, teaser | Black, sickly green, gray (#000000 #22C55E #6B7280) | “Something’s coming” teaser, minimal reveals | Flicker lights, glitch, slow zooms, negative space | Drones + risers, sparse hits | Low, ominous, minimal | Teasers, entertainment, launch intrigue |
+| Glitch Digital Hacker | glitch, digital, corrupted, data, matrix, hacker, distortion | Green, black, white (#22C55E #0B0F19 #F8FAFC) | Data-driven narrative, security promise, urgency | Datamosh, glitch cuts, code overlays, scanlines | Pulsing electronic, ticking urgency | Fast, urgent, precise | Cybersecurity, tech launches, announcements |
+| Minimal Monochrome Bold | monochrome, bold, graphic, silhouette, high contrast, modern | Black/white + one accent (#000000 #FFFFFF #A3E635) | Silhouettes + strong typography, minimal set | Hard edges, clean shapes, graphic wipes | Minimal beat, strong rhythm | Strong, assertive | Branding, apparel, statement campaigns |
+| One-Take Gimbal Smooth | one-take, gimbal, seamless, choreography, immersive, fluid | Depends on location (keep cohesive) | Follow talent through spaces, reveal product naturally | Hidden cuts, whip transitions, motivated camera moves | Continuous groove, evolving layers | Conversational, guided | Brand tours, hospitality, retail, storytelling |
+| Split-Screen Comparison | split-screen, comparison, before-after, features, fast, clear | Neutral + brand accents | Show problems vs solution, feature A/B, timelines | Split wipes, synchronized beats, labels | Upbeat but non-distracting, steady tempo | Clear, informative, confident | Performance ads, demos, education |
+| Stop Motion Handmade | stop motion, tactile, handmade, playful, charming, quirky | Warm paper tones, bright accents (#F5F5F4 #FB923C #3B82F6) | Objects animate themselves, craft story, playful assembly | Frame-by-frame jitter, paper textures, practical props | Playful marimba/ukulele, whimsical | Bright, charming, storybook | Snacks, kids, crafts, playful brands |
+| Claymation Whimsy | claymation, clay, quirky, cute, tactile, expressive, fun | Bright pastel mix (#FBCFE8 #BBF7D0 #BFDBFE) | Clay characters interact with product, simple gags | Fingerprint texture, squish/stretch, practical sets | Whimsical orchestration, bouncy | Friendly character voice, warm | Brand mascots, kids, playful campaigns |
+| Hand-Drawn Sketch Overlay | hand-drawn, sketch, doodle, annotation, educational, playful | Black ink + brand accents | Explain features with doodles on live footage | Scribble reveals, underline callouts, animated arrows | Light upbeat, minimal | Friendly, teacher-like | Tutorials, explainers, product tips |
+| Luxury Slow Motion Beauty | slow motion, elegance, premium, silk, water, macro, sensual | Black, ivory, gold (#0B0F19 #FFFBEB #D4AF37) | Silk fabrics, water splashes, elegant gestures | High-speed, pro-mist, controlled highlights, subtle sparkles | Cinematic, minimal strings + sub | Smooth, intimate, premium | Fragrance, jewelry, luxury skincare |
+| Street Interview Vox Pop | vox pop, interview, candid, street, quick, social proof | Natural, slightly warm | Quick Q&A montage, reactions, authentic answers | On-screen subtitles, quick cuts, handheld | Minimal bed, keep real ambience | Natural, spontaneous | Social proof, community, awareness |
+| ASMR Quiet Luxury | ASMR, quiet, subtle, texture, taps, whispers, premium | Neutral, soft shadows (#F8FAFC #E5E7EB #111827) | Sound-first product moments: click, pour, unwrap | Close mic foley, minimal movement, macro focus | Almost no music; subtle ambient tone | Whisper-soft, intimate | Product detail, sensory brands, premium |
+| Festival/Event Aftermovie | aftermovie, event, crowd, energy, highlights, confetti, lights | Saturated warm + neon highlights | Best moments montage, attendee reactions, performer shots | Light streaks, fast cuts, beat sync, flash frames | EDM/house, build + drop | Hype, energetic, crowd-leading | Events, conferences, community |
+| Charity / Humanitarian | humanitarian, empathy, real stories, hope, community, impact | Warm natural tones, soft contrast | Real people stories, community action, outcome moments | Natural light, intimate close-ups, minimal polish | Gentle piano + strings, uplifting | Empathetic, sincere, respectful | Fundraising, awareness, CSR |
+| Premium Hospitality | hospitality, boutique, travel, sensory, elegant, welcome | Warm wood, deep green, cream (#14532D #F5F5F4 #B45309) | Hotel/restaurant journey, check-in to experience | Smooth gimbal, warm practicals, lens flares | Lounge/nu-jazz, relaxed | Warm, inviting, refined | Hotels, restaurants, travel experiences |
+| Luxury Real Estate | real estate, architectural, premium, sunlight, spacious, modern | White, stone, deep navy (#FFFFFF #E7E5E4 #0F172A) | Walkthrough, lifestyle vignettes, sunrise/sunset | Wide lens, smooth pans, natural light, clean lines | Cinematic chill, soft pulses | Calm, confident, descriptive | Listings, developments, brand prestige |
+| Gaming Esports Hype | esports, hype, neon, fast, competitive, glitches, adrenaline | Neon green, purple, black (#A3E635 #7C3AED #0B0F19) | Player portraits, match moments, product tie-ins | Glitch cuts, RGB split, strobe, particle hits | Hard EDM/trap, heavy drops | High-energy, shoutcaster vibe | Tournaments, gaming products, promos |
+| Beauty “Get Ready With Me” | GRWM, routine, relatable, cozy, chatty, quick tips, candid | Warm indoor neutrals + blush | Step-by-step routine, product callouts, honest opinions | Jump cuts, captions, close-ups, mirror shots | Trendy pop, low volume | Chatty, friendly, peer-to-peer | Beauty performance, creator collabs |
+| Kitchen Recipe Cinematic | recipe, step-by-step, overhead, satisfying, clean, modern | Warm neutrals + food accents | Overhead prep, ingredient beauty shots, quick steps | Top-down rig, quick cuts, macro sizzles, text steps | Light groove + strong foley | Clear, instructional, appetizing | CPG, appliances, cooking channels |
+| Animated Mascot + Live Action | mascot, character, playful, hybrid, brand icon, fun | Brand palette + clean neutrals | Mascot interacts with real world, product helper | Match lighting/shadows, character reactions, pop transitions | Fun upbeat pop, simple hooks | Character voice, friendly | Brand recognition, family, snacks |
+| Premium “Apple-like” Product | sleek, minimal, premium, white space, precise, refined | White, graphite, subtle gradients (#FFFFFF #111827 #D1D5DB) | Feature-by-feature elegance, hands interaction, clean set | Perfect speculars, precise motion, subtle UI overlays | Minimal ambient, tasteful pulses | Calm, confident, understated | Hardware launches, premium tech |
+| Time-Lapse Transformation | timelapse, transformation, build, progress, makeover, reveal | Natural + brand accents | Renovations, setup builds, progress-to-reveal arc | Locked-off camera, speed ramps, match cuts | Motivational light rock/pop | Narrative, guiding, milestone-based | Construction, beauty makeovers, projects |
+| Corporate Testimonial Premium | testimonial, customer story, credibility, clean, trust, human | Neutral, warm highlights (#111827 #F8FAFC #F59E0B) | Customer interview + B-roll proof points | Two-camera setup, subtle b-roll overlays, tasteful titles | Soft corporate bed, unobtrusive | Warm, authentic, confident | B2B trust, case studies |
+| Product Comparison “Lab Battle” | comparison, battle test, durability, stress test, proof, challenge | Industrial gray, hazard yellow accent (#111827 #9CA3AF #FACC15) | Side-by-side tests, drop, water, speed, endurance | Slow motion impacts, on-screen metrics, lab set | Energetic rock/electro, punchy hits | Confident, competitive, factual | Performance marketing, product differentiation |
+| Cinematic Narrative Short | narrative, character, arc, tension, payoff, cinematic, emotional | Cinematic grade, controlled contrast | Mini short film with brand integrated naturally | Motivated lighting, scene transitions, score-led pacing | Cinematic score with emotional arc | Storyteller, emotional, controlled | Brand films, awareness, premium storytelling |

package/.opencode/skills/video/references/video-optimization.md

@@ -0,0 +1,95 @@
+# Video Optimization Guide
+
+## Thumbnail Best Practices
+
+### Design Rules
+- Bright, high-contrast colors
+- Face with expression (if applicable)
+- Large, readable text (3-4 words max)
+- Consistent brand style
+- Test at small size (mobile)
+
+### Thumbnail Specs
+| Platform | Size | Safe Zone |
+|----------|------|-----------|
+| YouTube | 1280x720 | Center 60% |
+| TikTok | 1080x1920 | Top third |
+| Instagram | 1080x1080 | Center |
+
+### What Works
+- Curiosity gap (incomplete info)
+- Before/after contrast
+- Numbers and lists
+- Emotion (surprise, curiosity)
+
+## Title Optimization
+
+### YouTube Title Formula
+`[Keyword] - [Benefit/Outcome] ([Qualifier])`
+
+Examples:
+- "Email Marketing - 5 Templates That Convert (Free Download)"
+- "Learn Python - Build Your First App in 30 Minutes"
+
+### Short-Form Captions
+- Hook in first line
+- Add context/story
+- Include hashtags
+- CTA at end
+
+## SEO for Video
+
+### YouTube SEO
+1. Keyword in title (front-load)
+2. Keyword in description (first 150 chars)
+3. Tags (primary + related)
+4. Chapters with keywords
+5. Closed captions
+
+### Description Template
+```
+[Hook - 1-2 sentences with keyword]
+
+[Timestamps/Chapters]
+0:00 Intro
+1:30 [Topic 1]
+...
+
+[Links and Resources]
+
+[About]
+
+[Hashtags]
+```
+
+## Retention Optimization
+
+### Improve Watch Time
+- Strong hook (first 5 sec)
+- Pattern interrupts every 30 sec
+- Open loops (tease what's coming)
+- Visual variety (cuts, b-roll)
+- Remove dead air
+
+### Reduce Drop-off
+- Cut slow intros
+- Front-load value
+- Use chapters
+- Match thumbnail promise
+
+## Repurposing Strategy
+
+### Long → Short
+- Extract 3-5 best moments
+- Add captions
+- Adjust aspect ratio
+- Platform-specific hooks
+
+### One Video → Multiple Assets
+- YouTube long-form
+- YouTube Shorts (3-5 clips)
+- TikTok/Reels versions
+- LinkedIn cut
+- Blog post embed
+- Email thumbnail + link
+- Social media clips