@milenyumai/film-kit 1.0.0

package/content/skills/audio-design/SKILL.md

@@ -0,0 +1,307 @@
+---
+name: audio-design
+description: Sound design rules for Veo 3.1. Voice realism, environmental sounds, SFX, ambience, and audio direction block formatting. Includes anti-synthetic audio guidelines.
+---
+
+# Audio Design System
+
+> **Philosophy:** Sound is half the experience. Audio must be as real as visuals.
+> **Core Principle:** Every sound recorded-quality. No synthetic giveaways.
+
+---
+
+## 🎯 Audio Realism Baseline
+
+### Human Voices (Ultra Realistic)
+
+| Requirement | Description |
+|-------------|-------------|
+| **Natural delivery** | Sound like real human actors |
+| **Breathing** | Natural breaths between phrases |
+| **Micro-pauses** | Authentic hesitation, thinking |
+| **Vocal imperfections** | Slight variations, not robotic |
+| **Emotional authenticity** | Genuine feeling, not performed reading |
+
+### ❌ Voice Artifacts to Avoid
+
+- Robotic TTS quality
+- Monotone delivery
+- Machine-like precision
+- Flat affect
+- Unnatural pacing
+- Over-articulation
+
+---
+
+## Environmental Sounds
+
+### Acoustic Space Matching
+
+| Environment | Acoustic Properties |
+|-------------|---------------------|
+| **Small room** | Tight reverb, close sounds |
+| **Large hall** | Natural echo, distant ambience |
+| **Outdoor open** | Minimal reverb, wind, distant sounds |
+| **Enclosed bunker** | Muffled, resonant, claustrophobic |
+| **Ship deck** | Wind, waves, metallic resonance |
+| **Ship interior** | Engine hum, creaking, contained |
+
+### Surface-Matched Footsteps
+
+```
+Wood: Creaking, hollow resonance
+Stone: Sharp, echoing impact
+Metal: Clanging, ringing
+Gravel: Crunching, shifting
+Dirt: Muffled, soft thuds
+Wet ground: Splashing, squelching
+```
+
+---
+
+## Military/Historical Sound Design
+
+### Artillery Sounds
+
+```
+Cannon fire: Deep boom, mechanical operation, recoil sounds
+Shell loading: Heavy metallic clunk, scraping
+Ammunition handling: Weight sounds, brass on metal
+Distant bombardment: Rumbling, delayed impact
+Near misses: Whistling, earth shaking, debris
+```
+
+### Naval Sounds
+
+```
+Ship engines: Deep thrumming, mechanical rhythm
+Hull creaking: Metal stress, wave impact
+Bridge ambience: Telegraph, commands, equipment
+Distant ships: Muffled horns, gunfire echoes
+Water: Waves, spray, impacts
+```
+
+### Bunker/Trench Sounds
+
+```
+Explosions above: Muffled booms, earth falling
+Structural stress: Creaking, dust falling
+Radio/telephone: Static, crackling, distant voices
+Soldier activity: Equipment rattling, footsteps, breathing
+Silence tension: Heartbeats, shallow breathing
+```
+
+---
+
+## Audio Direction Block Template
+
+Include at end of EVERY video prompt:
+
+```
+Audio direction:
+- Language: [TURKISH/ENGLISH/NONE]
+- Type: [Dialogue/SFX/Mixed/SFX Only]
+- Dialogue transcript: [Exact lines OR "NONE"]
+- SFX: [Specific sound effects list]
+- Ambience: [Environmental background]
+- Music: NONE  <-- (STRICT DEFAULT: Only change if user explicitly requests music)
+- Mix target: [Percentages, e.g., "Dialogue 60%, Ambience 30%, SFX 10%"]
+- No on-screen subtitles/captions.
+```
+
+### Example: Battle Scene
+
+```
+Audio direction:
+- Language: TURKISH
+- Type: Mixed
+- Dialogue transcript: "Şimdi tam zamanı. Bismillah, Ya Allah! Ateş serbest!"
+- SFX: Cannon fire, shell loading, mechanical recoil, distant explosions
+- Ambience: Wind, smoke whooshing, distant ship engines
+- Music: NONE
+- Mix target: Dialogue 50%, SFX 35%, Ambience 15%
+- No on-screen subtitles/captions.
+```
+
+### Example: Tense Waiting
+
+```
+Audio direction:
+- Language: NONE
+- Type: SFX Only
+- Dialogue transcript: NONE
+- SFX: Distant rumbling, earth shaking, debris falling, heartbeats
+- Ambience: Muffled explosions, soldiers breathing, equipment rattling
+- Music: NONE
+- Mix target: Ambience 70%, SFX 30%
+- No on-screen subtitles/captions.
+```
+
+### Example: Dialogue Scene
+
+```
+Audio direction:
+- Language: TURKISH
+- Type: Dialogue
+- Dialogue transcript: "Anladım paşam. Hemen harekete geçiyoruz."
+- SFX: Telephone click, paper rustling
+- Ambience: Bunker acoustics, distant explosions muffled
+- Music: NONE
+- Mix target: Dialogue 70%, Ambience 25%, SFX 5%
+- No on-screen subtitles/captions.
+```
+
+---
+
+## Anti-Synthetic Audio Rules
+
+### ❌ AVOID
+
+| Artifact | Description |
+|----------|-------------|
+| **Obviously synthesized** | AI-generated, robotic sounds |
+| **Stock library generic** | Overused, recognizable loops |
+| **Mismatched acoustics** | Sound doesn't match space |
+| **Floating audio** | No spatial grounding |
+| **Unnatural transitions** | Jarring sound cuts |
+| **Uniform volume** | No natural dynamics |
+
+### ✅ REQUIRE
+
+| Quality | Description |
+|---------|-------------|
+| **Recorded quality** | Sounds like on-set capture |
+| **Spatial grounding** | Sound has location in scene |
+| **Natural dynamics** | Volume variations realistic |
+| **Acoustic matching** | Sound matches environment |
+| **Organic imperfections** | Slight variations natural |
+
+---
+
+## Dialogue Handling
+
+### 🎯 NATIVE LANGUAGE RULE (CRITICAL!)
+
+**NEVER translate user's dialogue!**
+
+| User Writes In | Audio Transcript Uses |
+|----------------|----------------------|
+| Turkish | Turkish (as-is) |
+| English | English (as-is) |
+| Any language | Same language (verbatim) |
+
+```
+User: "Kalkın aslanlar! Düşman zırhlıları top menziline giriyorlar!"
+
+❌ WRONG: Dialogue transcript: "Rise lions! Enemy battleships are entering range!"
+✅ RIGHT: Dialogue transcript: "Kalkın aslanlar! Düşman zırhlıları top menziline giriyorlar!"
+```
+
+### When User Provides Dialogue
+
+- Include VERBATIM in audio transcript
+- Preserve original language (Turkish stays Turkish, English stays English)
+- Note emotional delivery required
+
+### 🗣️ SPEAKER ISOLATION RULE (Prevent Mixed Dialogue)
+
+**Problem:** If two people are in the frame and both speak, AI often mixes lipsync or timing.
+**Solution:** ONE active speaker per shot.
+
+- **Shot A:** Character X speaks. Camera focuses on X (or over-the-shoulder of Y).
+- **Shot B:** Character Y replies. Camera focuses on Y.
+
+**EXCEPTION:** If both MUST be in frame (Two-Shot):
+1. Use "Reaction Shot" for the listener (listener nods while speaker talks off-screen sound).
+2. OR Ensure prompt explicitly states: "[Character A] talking, [Character B] listening silently".
+
+```
+Dialogue transcript: "Kalkın aslanlar! Düşman zırhlıları top menziline giriyorlar!"
+[Delivery: Excited, commanding]
+```
+
+### When No Dialogue
+
+```
+Dialogue transcript: NONE
+```
+
+### Short Sentence Rule
+
+**DO NOT** try to fit very long sentences into a single shot.
+
+If dialogue is long:
+- Split the sentence across shots
+- OR split the shot in two
+- This helps AI with audio splitting
+
+```
+❌ Wrong: One 4s shot with 20 seconds of dialogue
+✅ Right: Split into multiple shots with shorter lines
+```
+
+---
+
+## Audio Safety
+
+| Rule | Requirement |
+|------|-------------|
+| **Minors on screen** | "Dialogue transcript: NONE" (platform requirement) |
+| **Violence context** | Describe SFX as "mechanical operation" not "firing at targets" |
+| **Threats** | Never script threatening dialogue |
+| **Copyrighted music** | Never reference by name |
+
+---
+
+## 🔇 NO MUSIC POLICY
+
+**Rule:** By default, generating music is BANNED.
+**Why:** Cinematic realism relies on SFX and Ambience. Cheap stock music ruins immersion.
+
+- **Default:** `Music: NONE`
+- **Exception:** Only if User says "Add sad music" or "Background score".
+- **Strictness:** Even if the scene is emotional, use *Silence* or *Wind*, NOT music.
+
+---
+
+## Mix Targets by Scene Type
+
+| Scene Type | Dialogue | SFX | Ambience | Music |
+|------------|----------|-----|----------|-------|
+| **Intense dialogue** | 70% | 5% | 25% | 0% |
+| **Action/battle** | 20% | 50% | 30% | 0% |
+| **Tension/waiting** | 0% | 30% | 70% | 0% |
+| **Emotional moment** | 60% | 10% | 30% | 0% |
+| **Establishing shot** | 0% | 20% | 80% | 0% |
+
+---
+
+## Period-Specific Audio Notes
+
+### WWI/Çanakkale
+
+```
+Artillery: Black powder era, deeper booms
+Ships: Coal-powered, rhythmic engine sounds
+Communication: Field telephone, no radio static
+Commands: Shouted, no PA systems
+Uniforms: Fabric rustling, leather creaking, metal equipment
+```
+
+---
+
+## 🔊 Diegetic vs Non-Diegetic Ses
+
+Ses'in kaynağına göre prompt'ta farklı yönetilmelidir:
+
+| Tür | Tanım | Örnekler | Prompt'ta Nasıl |
+|-----|-------|----------|----------------|
+| **Diegetic** | Sahne içinden gelen ses | Radyo, TV, konuşma, ayak sesi | SFX veya Dialogue olarak yaz |
+| **Non-Diegetic** | Sahne dışından gelen ses | Film müziği, narrator, efekt | Music veya voiceover olarak yaz |
+| **Meta-Diegetic** | Karakterin zihnindeki ses | İç ses, hatıra, hayal | "Internal monologue" + echo efekti |
+
+**Kural:** Veo 3.1'de tüm sesler diegetic olarak davranır. Non-diegetic müzik eklenecekse kullanıcı açıkça istemelidir (Music: NONE default).
+
+---
+
+> **Remember:** Audio sells the reality. A perfectly filmed scene fails if it sounds fake. Every sound must justify its existence and match its environment.