@milenyumai/film-kit 1.0.0

package/content/skills/prompt-structure/SKILL.md

@@ -0,0 +1,429 @@
+---
+name: prompt-structure
+description: Image and video prompt templates, camera movement vocabulary, stabilization styles, and prompt engineering best practices for Veo 3.1.
+---
+
+# Prompt Structure & Engineering
+
+> **Philosophy:** Precision breeds quality. Structure enables creativity.
+> **Core Principle:** Every word must earn its place. No fluff. No ambiguity.
+
+---
+
+## 🎯 Core Principles
+
+| Principle | Description |
+|-----------|-------------|
+| **Simplicity Over Complexity** | Start simple, iterate by adding detail |
+| **Positive Framing** | Describe what SHOULD happen (negative prompts less effective) |
+| **Specific Action Verbs** | "strides" > "walks", "glides" > "moves" |
+| **Professional Terms** | Use industry-standard cinematography language |
+| **Ideal Length** | 80-120 words per video prompt |
+| **Reference Commands First** | Always start with reference image instructions |
+| **Safety First** | Always consider filter implications |
+| **Short Sentence Rule** | Split long sentences across shots |
+
+---
+
+## Image Prompt Structure
+
+### ✏️ Prompt Akış Sırası (Veo Optimizasyonu)
+
+Veo ilk cümleye en çok ağırlık verir. **Her prompt bu sırayla yazılmalıdır:**
+
+| Sıra | İçerik | Örnek |
+|------|--------|-------|
+| **1** | Tek cümle sahne özeti | "Cinematic close-up of a young soldier in a dim bunker." |
+| **2** | Kim/Ne/Nerede | Karakter fiziksel tanımı, kıyafet, konum |
+| **3** | Aksiyon | Ne yapıyor, mikro-davranış, oyunculuk |
+| **4** | Kamera + Lens | "85mm f/2.0, shallow DOF, handheld" |
+| **5** | Işık + Atmosfer | "Warm oil lamp, dramatic side shadows" |
+| **6** | Audio direction | Sadece video prompt'larında |
+| **7** | Avoid line | HER prompt'ta zorunlu |
+
+> **İlk cümle = "Bu shot ne?" sorusunun tek cümlelik cevabı olmalı.**
+
+### Standard Template
+
+```
+[REFERENCE LOCK section if applicable]
+
+Cinematic still frame of [subject with reference adherence] in [frozen pose].
+[Environment + time of day].
+Lighting: [specific setup].
+Camera: [framing], [lens mm], [aperture], photorealistic, crisp focus, no motion blur, no text.
+[Safety injection if needed]
+
+[Full avoid line]
+```
+
+### Example: Character in Environment
+
+```
+[REFERENCE LOCK] Using uploaded reference image: The soldier - Match this person's face EXACTLY. Do NOT invent new facial features.
+
+Cinematic still frame of the person from the reference, wearing dusty Ottoman artillery uniform, standing beside a massive artillery piece, one hand on the cannon barrel, determined expression. Ottoman coastal fortification, smoke-filled atmosphere, late afternoon harsh sunlight.
+Lighting: Dramatic side-light from setting sun, long shadows, dust particles visible in light beams.
+Camera: Medium shot, 35mm lens, f/4, photorealistic, crisp focus, no motion blur, no text.
+Maintaining exact likeness from the reference throughout. Historical reenactment style. Documentary approach.
+
+Avoid: blurry, low-res, noise, distorted faces, bad anatomy, extra limbs/fingers, plastic skin, waxy skin, airbrushed skin, on-screen text, watermark, logo, cartoon style, CGI look, different face than reference.
+```
+
+---
+
+## Video Prompt Structure
+
+### Standard Template
+
+```
+Use the provided first frame as exact starting composition. End on provided last frame as exact final composition.
+
+[REFERENCE LOCK section if applicable - maintaining character/object consistency from references]
+
+[Subject + specific attributes] + [Action verb + motion details] + [Environment + time of day] + [Lighting details].
+Camera: [start → end position], [movement type], [stabilization].
+
+Audio direction:
+- Language: [LANGUAGE]
+- Type: [Type]
+- Dialogue transcript: [Lines or NONE]
+- SFX: [Effects list]
+- Ambience: [Background sounds]
+- Music: NONE
+- Mix target: [Percentages]
+- No on-screen subtitles/captions.
+
+[Full avoid line]
+```
+
+### Example: Action Shot
+
+```
+Use the provided first frame as exact starting composition. End on provided last frame as exact final composition.
+
+[REFERENCE LOCK] Maintaining exact character likeness from the uploaded character reference throughout. The same person from the reference, not a similar one. Do NOT modify facial features.
+
+The person from the reference, wearing strained Ottoman artillery uniform, hoists a massive artillery shell onto his shoulder. Visible effort and strain. Beside him, a younger soldier in matching uniform pushes from behind, providing support. Ottoman artillery position, smoke drifting through, harsh afternoon light casting dramatic shadows. Dust particles float in sunbeams.
+Camera: Low angle medium shot, slight push-in on the soldiers' straining faces, handheld organic movement, capturing the gravity of their effort.
+
+Audio direction:
+- Language: TURKISH
+- Type: Mixed
+- Dialogue transcript: "Güç ve kuvvet sahibi Allah'tır. Haydi Bismillah."
+- SFX: Heavy metal scraping, grunting with effort, fabric straining, boot scuffing on stone
+- Ambience: Distant cannon fire, wind, smoke whooshing
+- Music: NONE
+- Mix target: Dialogue 40%, SFX 40%, Ambience 20%
+- No on-screen subtitles/captions.
+
+Avoid: distorted faces, morphing, bad anatomy, extra limbs/fingers, blurry, flickering, inconsistent lighting, unnatural motion, on-screen text, watermark, cartoon style, CGI motion, different face than reference.
+```
+
+---
+
+## Camera Movement Vocabulary
+
+### Primary Movements
+
+| Movement | Description | Use When |
+|----------|-------------|----------|
+| **Dolly push-in** | Camera moves toward subject | Building intensity, focus |
+| **Dolly pull-out** | Camera moves away from subject | Reveal, context, ending |
+| **Pan left/right** | Camera rotates horizontally | Following action, scanning |
+| **Tilt up/down** | Camera rotates vertically | Reveal height, power dynamics |
+| **Crane rise** | Camera elevates vertically | Grand reveal, establishing |
+| **Crane descend** | Camera lowers vertically | Intimate approach |
+| **Orbit** | Camera circles subject | Dramatic emphasis, 360 view |
+| **Tracking** | Camera follows alongside | Following movement |
+| **Rack focus** | Focus shifts between planes | Attention shift, reveal |
+| **Whip pan** | Camera rotates rapidly (snap) | Transition between subjects, hide cuts, energy burst |
+
+### Movement Combinations
+
+```
+"Slow dolly push-in while panning left"
+"Crane rise into tracking shot"
+"Orbit at medium distance, maintaining focus on subject"
+```
+
+---
+
+## Stabilization Styles
+
+| Style | Effect | Use For |
+|-------|--------|---------|
+| **Locked/Tripod** | No movement, static | Dialogue, still moments |
+| **Gimbal smooth** | Stabilized glide | Premium, commercial feel |
+| **Handheld organic** | Slight shake | Documentary, tension, realism |
+| **Handheld intense** | Visible shake | Action, chaos, urgency |
+| **Drone stabilized** | Smooth aerial | Establishing, landscapes |
+| **Steadicam** | Smooth follow | Long takes, walking with character |
+
+---
+
+## Shot Duration Guidelines
+
+| Scene Type | Duration | Why |
+|------------|----------|-----|
+| **Action/Impact** | 4s | Quick cuts maintain energy |
+| **Standard scene** | 8s | Balanced, most common |
+| **Emotional/drama** | 8s | Let moment breathe |
+| **Dialogue heavy** | 8s | Time for delivery |
+| **Establishing** | 8s | Set scene quickly |
+
+---
+
+## 🎲 Seed Parameter (Tutarlılık Kontrolü)
+
+Veo, `seed` parametresiyle aynı prompt'tan **daha deterministik** sonuçlar üretebilir.
+
+### Ne Zaman Kullanılır?
+
+| Durum | Seed Stratejisi |
+|-------|----------------|
+| **Aynı sahnede birden fazla açı** | Aynı seed → karakter/mekân tutarlılığı artar |
+| **Coverage shot'ları (OTS A/B)** | Aynı seed → kıyafet/ışık/mekan sürekliliği |
+| **Farklı sahneler** | Farklı seed → doğal varyasyon |
+| **Yeniden üretim (re-render)** | Önceki seed → benzer sonuç |
+
+### Pratik Kullanım
+
+```
+Seed AYNI tut:
+- Aynı sahne, farklı kamera açısı
+- Master shot + coverage arasında
+- Extend ile uzatma öncesi/sonrası
+
+Seed DEĞİŞTİR:
+- Farklı lokasyon/zaman
+- Tamamen yeni sahne
+- Farklı karakter girişi
+```
+
+### Vertex AI Seed Desteği
+
+- Destekleyen arayüzlerde seed parametresi gönderilebilir
+- Aynı seed + aynı prompt = daha benzer (ama garanti değil) çıktı
+- Referans görselle birlikte seed → tutarlılık daha da güçlenir
+
+> **Not:** Seed tek başına tutarlılık garantisi vermez. **Referans kilitleme + seed** kombinasyonu en iyi sonucu verir.
+
+---
+
+## 🤖 Prompt Rewriter Davranışı (Veo İç Mekanizması)
+
+Veo 3/3.1'de dahili bir **prompt enhancement/rewriter** mekanizması çalışır. Bu mekanizmanın nasıl çalıştığını bilmek, prompt kontrolünü artırır.
+
+### Nasıl Çalışır?
+
+| Durum | Model Davranışı |
+|-------|----------------|
+| **Kısa prompt** (10-20 kelime) | Model agresif biçimde "tamamlar" → kontrol kaybı |
+| **Orta prompt** (40-60 kelime) | Kısmi tamamlama → orta kontrol |
+| **Uzun/spesifik prompt** (80-120 kelime) | Minimal tamamlama → yüksek kontrol |
+
+### Kontrol Stratejisi
+
+```
+❌ ZAYIF KONTROL (model çok tamamlar):
+"Two soldiers talking in a bunker"
+
+✅ GÜÇLÜ KONTROL (model az tamamlar):
+"Two Ottoman soldiers, early 30s, full dark mustaches, dusty khaki uniforms, 
+sitting at a wooden table inside a cramped stone bunker. Dim oil lamp light, 
+warm orange glow on faces, deep shadows on walls. Medium two-shot, 50mm, f/2.8, 
+handheld organic. Older soldier leans forward, speaking intently. Younger soldier 
+listens, eyes cast down, tension in his jaw."
+```
+
+### Kritik Kurallar
+
+1. **80-120 kelime hedefi** doğrudan rewriter'ın müdahale alanını daraltır
+2. **Kamera, ışık, davranış, ses** ne kadar detaylı → model o kadar az uydurur
+3. Veo 3/3.1'de rewriter'ı **kapatma seçeneği yoktur** — spesifik yazmak tek çözüm
+4. Kısa prompt'larda model genişlettiği prompt'u gösterir → kontrol ederek öğrenebilirsin
+
+> **Altın Kural:** Prompt'taki her detay, model'in "yaratıcı boşluğunu" daraltır. Daha fazla detay = daha fazla kontrol.
+
+---
+
+## Lens Selection Guide
+
+| Lens | Effect | Use For |
+|------|--------|---------|
+| **24mm** | Wide, environmental | Establishing, scale |
+| **35mm** | Natural wide | Groups, environment + subject |
+| **50mm** | Natural, most realistic | Standard coverage |
+| **85mm** | Portrait, compression | Close-ups, intimacy |
+| **135mm** | Telephoto, compression | Distant observation, isolation |
+| **200mm+** | Extreme compression | Surveillance, extreme distance |
+
+### Aperture Effects
+
+| Aperture | Depth of Field | Use For |
+|----------|----------------|---------|
+| **f/1.4-2.0** | Very shallow | Extreme focus isolation |
+| **f/2.8** | Shallow | Portrait, subject isolation |
+| **f/4** | Medium | Balanced, some background |
+| **f/5.6-8** | Deep | Environmental, context |
+| **f/11+** | Very deep | Landscapes, everything sharp |
+
+---
+
+## Action Verb Upgrades
+
+Replace weak verbs with specific, cinematic alternatives:
+
+| Weak | Strong Alternatives |
+|------|---------------------|
+| walks | strides, trudges, marches, staggers, shuffles |
+| runs | sprints, dashes, bolts, charges, scrambles |
+| looks | gazes, peers, glares, scans, scrutinizes |
+| talks | whispers, shouts, mutters, commands, pleads |
+| moves | glides, lurches, pivots, lunges, retreats |
+| holds | grips, clutches, cradles, hefts, brandishes |
+| falls | collapses, tumbles, crumbles, drops, plummets |
+
+---
+
+## Cinematic Description Templates
+
+### Character Introduction
+
+```
+[Character description], [age], [distinctive feature], [costume].
+[Posture/body language] communicating [emotion/intent].
+[Specific detail] catching the light.
+```
+
+### Action Moment
+
+```
+[Character] [strong action verb] with [quality of motion].
+[Physical detail] visible as [evidence of effort/emotion].
+[Environmental reaction] to the action.
+```
+
+### Emotional Beat
+
+```
+[Character's] expression shifts from [state A] to [state B].
+[Micro-detail: eyes, mouth, hands] betraying [inner state].
+A beat of [silence/stillness/tension] before [next action].
+```
+
+### Environmental Establishing
+
+```
+[Wide view] of [location] at [time of day].
+[Atmospheric elements: light, weather, particles] defining the mood.
+[Scale elements] establishing the [grandeur/intimacy/danger].
+```
+
+---
+
+## Prompt Length Guidelines
+
+| Prompt Type | Words | Structure |
+|-------------|-------|-----------|
+| **Image prompt** | 60-100 | Reference + Description + Technical + Avoid |
+| **Video prompt** | 80-120 | Frame instructions + Reference + Action + Camera + Audio + Avoid |
+
+### If Prompt Too Long
+
+1. Split into multiple shots
+2. Remove redundant descriptors
+3. Combine phrases ("harsh afternoon light" not "harsh light in the afternoon")
+4. Use professional shorthand ("CU" for close-up in notes, full term in prompt)
+
+---
+
+## Quality Checklist
+
+Before finalizing any prompt:
+
+- [ ] Reference section at start? (if applicable)
+- [ ] Subject clearly described?
+- [ ] Action verbs specific?
+- [ ] Camera movement defined?
+- [ ] Lens and aperture specified?
+- [ ] Lighting described?
+- [ ] Audio direction complete? (video only)
+- [ ] Avoid line included?
+- [ ] Length within guidelines?
+
+---
+
+## 🔄 Re-Take Strategy (Yeniden Üretim Protokolü)
+
+Veo glitch veya istenmeyen sonuç ürettiğinde:
+
+### Hata Tipine Göre Müdahale
+
+| Hata | Prompt'ta Ne Değiştir | Seed |
+|------|----------------------|------|
+| **Yüz bozulması** | "photorealistic face, sharp features" ekle, Avoid'a "distorted face, morphing" güçlendir | Yeni seed dene |
+| **Ekstra uzuv/parmak** | Avoid'a "extra limbs, extra fingers, merged hands" ekle | Yeni seed |
+| **Hareket tutarsızlığı** | Hareketi sadeleştir, daha az eylem | Aynı seed, sadeleşmiş prompt |
+| **Işık zıplaması** | Işık kaynağını daha spesifik tanımla | Aynı seed |
+| **Karakter tutarsız** | Reference lock'u güçlendir, "EXACTLY" 3x tekrarla | Aynı seed |
+| **Arka plan kayması** | Arka planı daha detaylı tanımla | Aynı seed |
+| **Robotik hareket** | "Organic natural movement" ekle, micro-davranış koy | Yeni seed |
+
+### Re-Take Süreci
+
+```
+1. İLK DENEME: Orijinal prompt
+2. Glitch varsa: Hata tipini belirle
+3. İKİNCİ DENEME: Prompt ayarla (yukarıdaki tabloya göre)
+4. Hâlâ sorun: Seed değiştir + prompt'u sadeleştir
+5. ÜÇÜNCÜ DENEME: Kamera açısını veya frame'i değiştir
+6. 3 denemeden sonra: Shot'u daha kısa parçalara böl (8s→4s+4s)
+```
+
+> **Kural:** 3 başarısız denemeden sonra shot'u bölmek genellikle en etkili çözümdür.
+
+---
+
+## 📏 Coverage Prompt Yazım Standartları
+
+> **❗ COVERAGE = ANA SHOT KALİTESİNDE OLMALIDIR. KISA PROMPT YASAKTIR.**
+
+### Minimum Gereksinimler
+
+| Prompt Tipi | Min Kelime | İçermesi Gerekenler |
+|-------------|-----------|---------------------|
+| Coverage Image | **60 kelime** | Subject + camera + lens + lighting + emotion + Avoid |
+| Coverage Video | **60 kelime** | Action + camera movement + atmosphere + Audio block + Avoid |
+
+### Kısa Coverage Nasıl Uzatılır?
+
+```
+❌ KISA (25 kelime — REDDEDİLECEK):
+"Close-up reaction shot of the soldier listening. Soft light. 
+Avoid: blurry, distorted."
+
+✅ TAM (70 kelime — KABUL):
+"Close-up reaction shot of a young soldier, early 20s, thick dark mustache, 
+dusty khaki uniform. Eyes fixed on the speaker, slight tension in jaw, 
+brow furrowed. Soft key light from screen-left, warm orange oil lamp glow. 
+85mm f/2.0, shallow depth of field, background softly blurred. 
+Static camera, handheld organic micro-movement. 
+Photorealistic, cinematic grain.
+
+Avoid: blurry, low-res, noise, distorted faces, bad anatomy, extra limbs/fingers, 
+plastic skin, waxy skin, on-screen text, watermark, logo, cartoon style, CGI look."
+```
+
+### Coverage'da Eklenmesi Gereken Detaylar
+
+1. **Karakter fiziksel tanımı** (yaş, saç, bıyık, kıyafet)
+2. **Duygusal durum** (gerilim, korku, merak — mikro-davranış)
+3. **Kamera** (lens mm, aperture, stabilization)
+4. **Işık** (yön, renk sıcaklığı, kaynak)
+5. **Avoid satırı** (tam versiyon, kısaltma YOK)
+
+---
+
+> **Remember:** A great prompt is like a great shot list — nothing wasted, everything intentional. Write like a director who knows exactly what they want to see.