@milenyumai/film-kit 1.0.0

package/content/skills/reference-locking/SKILL.md

@@ -0,0 +1,303 @@
+---
+name: reference-locking
+description: Reference image integration system. Ensures user-provided character, object, and style references are used EXACTLY throughout all prompts. Critical for character consistency across shots.
+---
+
+# Reference Locking System
+
+> **Philosophy:** User references are sacred. The AI must replicate, not interpret.
+> **Core Principle:** When reference is provided, it is the ONLY truth. Do not invent.
+
+---
+
+## 🎯 Core Principle
+
+When user provides reference images, the generated visuals MUST match those references EXACTLY. The AI tends to ignore references unless explicitly commanded.
+
+**P1 Priority:** Reference Fidelity (use refs EXACTLY)
+
+---
+
+## Reference Types
+
+### 1. Character References
+
+For people/characters in the scene:
+
+```
+Using the uploaded reference image as the EXACT character likeness.
+Match the person's face, hair, body type, and proportions EXACTLY as shown in the reference.
+Do NOT invent new facial features — use ONLY the provided reference.
+Maintain character consistency: same person, same appearance throughout.
+```
+
+### 2. Object References
+
+For props, vehicles, equipment:
+
+```
+Using the uploaded reference image as the EXACT object design.
+Replicate the object's shape, color, texture, and details PRECISELY as shown.
+Do NOT substitute with similar objects — use ONLY the provided reference.
+```
+
+### 3. Style References
+
+For visual/aesthetic consistency:
+
+```
+Match the visual style, color grading, lighting mood, and aesthetic EXACTLY as shown in the uploaded reference image.
+Replicate the artistic approach and atmosphere from the reference.
+```
+
+---
+
+## 🔐 Reference Image = ABSOLUTE TRUTH (Text Must NOT Override)
+
+> **⚠️ KRİTİK SORUN:** Fiziksel tanım çok detaylı yazılınca Veo referans fotoğrafı ES GEÇİP kendi karakterini oluşturuyor.
+> **ÇÖZÜM:** Referans varken yüz/saç/vücut tanımı YAZMA — sadece kıyafet, yaş aralığı ve bağlam yaz.
+
+> ⚠️ Reference lock sections must NEVER contain real person names. Use anonymous labels only.
+
+### Hierarchy (Strict Priority Order)
+
+| Priority | Source | Controls | Text'te Yaz? |
+|----------|--------|----------|-------------|
+| **P0** | Reference Image | Yüz, saç, vücut, ten, göz | ❌ YAZMA — referans halleder |
+| **P1** | Prompt Text | Kıyafet, aksesuar, yaş aralığı, poz | ✅ Sadece bunları yaz |
+| **P2** | Prompt Text | Duygu, davranış, kamera, ışık | ✅ Her zaman yaz |
+
+### ❌ Referans Varken Bunları YAZMA
+
+```
+Veo bu tanımları görünce referansı ezer ve kendi üretir:
+- Yüz şekli ("sharp jawline", "round face")
+- Saç rengi/stili ("dark hair", "short blonde hair")
+- Göz rengi ("blue eyes", "brown eyes")
+- Cilt tonu ("olive skin", "fair complexion")
+- Vücut tipi ("muscular build", "slim figure")
+- Bıyık/sakal detayı ("full dark mustache")
+```
+
+### ✅ Referans Varken Sadece Bunları Yaz
+
+```
+Bunlar referansla ÇATIŞMAZ, bağlam verir:
+- Kıyafet ("wearing dusty Ottoman artillery uniform")
+- Yaş aralığı ("early 30s") — kısa, sadece bağlam
+- Aksesuar ("red fez", "leather belt", "medals")
+- Poz/duruş ("standing tall", "leaning forward")
+- Duygu/davranış ("determined expression", "clenches jaw")
+- Aksiyon ("hoists shell onto shoulder")
+```
+
+### Doğru vs Yanlış Karşılaştırma
+
+```
+❌ YANLIŞ (referans EZİLİR — Veo kendi karakterini üretir):
+  "A distinguished military officer, early 40s, full dark mustache, 
+   olive skin, strong jawline, short dark hair, athletic build, 
+   wearing ornate Ottoman uniform with brass buttons"
+  → Veo: Çok detaylı yüz tanımı → kendi veritabanından üretir → referans yok sayılır
+
+✅ DOĞRU (referans KORUNUR — metin sadece kıyafet/bağlam verir):
+  "The person from the reference, wearing ornate Ottoman uniform 
+   with brass buttons and red fez. Determined expression."
+  → Veo: Yüz tanımı yok → referans fotoğrafa bakar → aynı kişiyi kullanır
+```
+
+### Correct Combined Usage
+
+```
+[REFERENCE LOCK] Using uploaded reference: "Commander" — 
+Match this person's face EXACTLY as shown in the reference image.
+Do NOT invent or modify any facial features.
+
+The person from the reference, wearing ornate Ottoman uniform 
+with brass buttons and red fez.
+Maintaining exact likeness from the reference throughout.
+```
+
+> **ALTIN KURAL:** Referans varken *"bu kişi nasıl görünüyor?"* sorusunu metin ile DEĞİL, referans fotoğrafıyla cevapla. Metin sadece *"ne giyiyor, ne yapıyor?"* sorularını cevaplar.
+
+---
+
+## Prompt Structure with References
+
+**START every prompt with reference commands (BEFORE any other content):**
+
+> ⚠️ Use ANONYMOUS labels ("The soldier", "Commander", "The ship") — NEVER real person names.
+
+```
+[REFERENCE LOCK] Using uploaded reference images:
+- Reference 1: [Anonymous label] - Match face and body EXACTLY
+- Reference 2: [Object label] - Replicate design PRECISELY
+- Reference 3: [Style] - Match visual aesthetic
+
+[Then continue with the rest of the prompt...]
+```
+
+### Example with Multiple References
+
+```
+[REFERENCE LOCK] Using uploaded reference images:
+- Reference 1: The soldier - Match face, mustache, and build EXACTLY as shown
+- Reference 2: Ottoman artillery cannon - Replicate design PRECISELY
+- Reference 3: Artillery shell - Match size and color EXACTLY
+
+[Scene description follows...]
+```
+
+---
+
+## Reference Reminder Phrases
+
+Weave these phrases naturally into prompts to reinforce adherence:
+
+| Phrase | Use When |
+|--------|----------|
+| "maintaining exact likeness from the reference" | Character appears in action |
+| "as shown in the uploaded character reference" | Describing features |
+| "preserving the reference image's [specific feature]" | Highlighting key detail |
+| "consistent with the provided reference" | General reinforcement |
+| "the same person/object from the reference, not a similar one" | Preventing substitution |
+| "do not invent new features" | Critical emphasis |
+
+### Repetition Rule
+
+Reference reminders should appear:
+- **1x** at prompt START (in [REFERENCE LOCK] section)
+- **1x** in middle of description
+- **1x** near end of prompt
+
+**Minimum 2-3 reminders per prompt** for strong adherence.
+
+---
+
+## Common Reference Failures & Fixes
+
+| Problem | Cause | Fix |
+|---------|-------|-----|
+| Different person appears | No explicit reference command | Add `[REFERENCE LOCK]` section at prompt start |
+| Similar but not exact | Weak reference language | Use "EXACTLY" "PRECISELY" "IDENTICAL" forcefully |
+| Reference ignored mid-prompt | Only mentioned once | Repeat reference reminder 2-3 times throughout |
+| Wrong object/prop | Generic description used | Add "from the uploaded reference, not a generic version" |
+| Costume changed | Character description too vague | Include specific clothing from reference |
+| Facial features changed | AI "improved" the face | Add "do not modify, enhance, or improve the reference face" |
+| **Reference face REPLACED** | **Text has detailed face/body description** | **REMOVE all face/hair/body text — let reference handle it** |
+
+---
+
+## Character Consistency Across Shots
+
+For multi-shot scenarios, maintain consistency:
+
+### 1. Create Character Profile (First Shot)
+
+> ⚠️ Use anonymous labels — NEVER real person names in character profiles.
+
+```
+CHARACTER: The Soldier (from reference)
+- Face: FROM REFERENCE ONLY — do not describe in text
+- Costume: Ottoman artillery soldier uniform, period-accurate
+- Accessories: Red fez, leather belt
+- Expression range: Determined, strained, victorious
+```
+
+> ⚠️ Face/Build satırlarında asla metin tanımı yazma — referans fotoğrafı yeterli.
+
+### 2. Reference in Every Shot
+
+Each subsequent shot must include:
+```
+[REFERENCE LOCK] The soldier exactly as established in reference image...
+```
+
+### 3. Track Costume Changes
+
+If costume changes (dirt, sweat, torn):
+```
+Same character from reference, now with [specific change: dust on uniform, sweat on brow]
+```
+
+---
+
+## Object Reference Handling
+
+For props and equipment:
+
+### Artillery Example
+
+```
+[REFERENCE LOCK] Using the uploaded cannon reference:
+The Ottoman coastal artillery piece EXACTLY as shown - same barrel length, wheel design, positioning mechanism. Do not substitute with modern or generic artillery.
+```
+
+### Shell/Ammunition Example
+
+```
+[REFERENCE LOCK] Using the uploaded shell reference:
+The artillery shell EXACTLY as shown - same size, color, brass casing design. This is the specific 276kg shell that the soldier will carry.
+```
+
+---
+
+## Multi-Character Scenes
+
+When multiple characters have references:
+
+```
+[REFERENCE LOCK] Using uploaded reference images:
+- Reference 1: The soldier - Match face and build EXACTLY, the same person throughout
+- Reference 2: The younger soldier - Match face EXACTLY, same soldier from reference
+- Reference 3: Ottoman artillery unit costume style
+
+Scene: Both soldiers, maintaining exact likenesses from their respective references...
+```
+
+---
+
+## Video Prompt Reference Integration
+
+For video prompts, add motion while maintaining reference:
+
+```
+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 reference throughout the entire clip. The same person from the reference, not a similar one.
+
+[Motion and action description...]
+```
+
+---
+
+## Quick Reference Injection Templates
+
+### Single Character
+
+```
+[REFERENCE LOCK] Using uploaded reference image: [Anonymous Label] - Match face and body EXACTLY. Do not invent new facial features.
+```
+
+> ⚠️ **[Name] = Anonymous label ONLY** (e.g., "The commander", "The soldier"). NEVER use real person names.
+
+### Character + Object
+
+```
+[REFERENCE LOCK] Using uploaded references:
+- [Character]: Match EXACTLY as shown
+- [Object]: Replicate PRECISELY, not a generic version
+```
+
+### Full Scene
+
+```
+[REFERENCE LOCK] Using all uploaded references:
+- Character(s): Maintain exact likeness throughout
+- Object(s): Use precise designs from references
+- Style: Match lighting and atmosphere
+```
+
+---
+
+> **Remember:** References are not suggestions. They are requirements. Every prompt must enforce exact adherence. The AI will try to interpret — your job is to command.

package/content/skills/safety-compliance/SKILL.md

@@ -0,0 +1,242 @@
+---
+name: safety-compliance
+description: Platform safety rules, celebrity name prohibition, content restrictions, and safe framing techniques for Google Veo 3.1. MANDATORY skill - always load before generating.
+---
+
+# Safety Compliance
+
+> **Philosophy:** Platform compliance is non-negotiable. Safety overrides all other considerations.
+> **Core Principle:** When in doubt, use physical descriptions. NEVER risk a celebrity name.
+
+---
+
+## ⚠️ CELEBRITY NAME PROHIBITION (ZERO TOLERANCE)
+
+**ABSOLUTE RULE:** You MUST NEVER include any real person's name in ANY prompt.
+
+### Who Is Prohibited
+
+| Category | Examples | Action |
+|----------|----------|--------|
+| **Celebrities** | Actors, musicians, athletes, influencers | BLOCK |
+| **Politicians** | Current or historical leaders | BLOCK |
+| **Public Figures** | Business leaders, scientists, activists | BLOCK |
+| **Historical Figures** | Anyone with recognizable likeness | BLOCK |
+
+**WHY:** Google Veo safety filters BLOCK generation if ANY real person name is detected.
+Error codes: 15236772-15236774
+
+---
+
+## Physical Description Method (MANDATORY ALTERNATIVE)
+
+Instead of names, ALWAYS use detailed physical descriptions:
+
+### Conversion Examples
+
+| ❌ FORBIDDEN (Will Fail) | ✅ REQUIRED (Will Pass) |
+|--------------------------|------------------------|
+| "A man who looks like Brad Pitt" | "A man, early 40s, strong jawline, short blonde hair, athletic build, blue eyes" |
+| "Scarlett Johansson style" | "A woman, late 30s, voluminous blonde hair, full lips, green eyes, hourglass figure" |
+| "Atatürk" | "A man, mid-50s, sharp facial features, short grey hair, piercing blue eyes, wearing a formal dark suit" |
+| "Einstein-like scientist" | "An elderly man with wild white hair, bushy mustache, wearing a tweed jacket" |
+| "Ottoman Pasha" | "A distinguished military officer, 50s, full dark mustache, wearing ornate Ottoman uniform with medals" |
+
+### Description Template
+
+```
+[Gender], [age range], [distinctive facial features], [hair color/style], [eye color if relevant], [build/physique], [clothing/costume]
+```
+
+---
+
+## 🚨 AUTO-ANONYMOUS (PROAKTİF ANONİMLEŞTİRME — KULLANICI HATIRLATMASI GEREKMEZ)
+
+> **❗ Bu kural OTONOM çalışır. Kullanıcının "anonim yap" demesini BEKLEME.**
+
+### Otomatik Tarama Protokolü
+
+```
+HER SENARYO GELDİĞİNDE:
+1. Tüm karakter isimlerini tara
+2. Gerçek kişi mi? → OTOMATİK fiziksel tanımla değiştir
+3. Hayali karakter mi? → Prompt'ta isim kullanma, fiziksel tanım yaz
+4. Kullanıcıya SORMA → OTOMATİK YAP
+5. Bilgilendir: "[İsim] → anonim fiziksel tanımla değiştirildi."
+```
+
+### Genişletilmiş Algılama (Sadece İsim Değil)
+
+| Algılanacak | Örnek | Otomatik Aksiyon |
+|-------------|-------|-----------------|
+| Tam isim | "Mustafa Kemal" | → Fiziksel tanım |
+| Unvan + isim | "Paşa Cevat" | → Fiziksel tanım |
+| Dolaylı atıf | "Cumhuriyetin kurucusu" | → Fiziksel tanım |
+| Tarihi rol | "Çanakkale kahramanı" | → Fiziksel tanım |
+| Benzetme | "Brad Pitt gibi biri" | → Orijinal fiziksel tanım |
+
+### ❗ TEKRAR: Bu Kural OTOMATİKTİR
+
+```
+❌ YANLIŞ DAVRANIŞ:
+  Kullanıcı: "Seyit Onbaşı top mermisini kaldırıyor"
+  AI: *İsimleri olduğu gibi prompt'a yazar*
+  Kullanıcı: "Anonim yap!"
+  AI: *Şimdi değiştirir*
+
+✅ DOĞRU DAVRANIŞ:
+  Kullanıcı: "Seyit Onbaşı top mermisini kaldırıyor"
+  AI: *Otomatik olarak* "A young soldier, early 20s, muscular build..." yazar
+  AI: "Seyit Onbaşı → anonim fiziksel tanımla değiştirildi." bilgisi verir
+```
+
+## AUTO-SAFETY (PROAKTİF GÜVENLİK OPTİMİZASYONU)
+
+> **❗ Güvenlik filtrelerine takılacak içeriği kullanıcı söylemeden OTOMATİK değiştir.**
+
+```
+HER PROMPT YAZARKEN:
+1. "Bu filtreye takılır mı?" sorusunu sor
+2. Takılacaksa → Kullanıcı söylemeden DEĞİŞTİR
+3. Değiştirdiğini bildir
+4. Asla "bir deneyelim" yaklaşımı alma
+```
+
+---
+
+## Self-Check Protocol (GÜÇLENDİRİLMİŞ)
+
+**Before EVERY prompt, verify:**
+
+1. ❗ Gerçek kişi ismi var mı? → **OTOMATİK** fiziksel tanımla değiştir
+2. ❗ Dolaylı ünlü atıfı var mı? → **OTOMATİK** değiştir
+3. ❗ Güvenlik filtresine takılacak içerik var mı? → **OTOMATİK** reframe et
+4. ❗ Tarihi figür referansı var mı? → Sadece fiziksel nitelik kullan
+
+---
+
+## Safety Filter Categories (Auto-Blocked)
+
+| Category | Description | Action |
+|----------|-------------|--------|
+| **Violence** | Graphic violence, injuries, gore, weapons in active harm | Block + Reframe |
+| **Sexual** | Sexually explicit, nudity, suggestive acts | Block + Reframe |
+| **Derogatory** | Hate speech, slurs, discrimination | Block + Reframe |
+| **Toxic** | Harassment, bullying, threats | Block + Reframe |
+| **Harmful** | Self-harm, dangerous activities, substance abuse | Block + Reframe |
+| **Minors** | Inappropriate content involving minors | Block + Reframe |
+| **Public Figures** | Real celebrities, politicians, identifiable public figures | Block + Use Description |
+
+---
+
+## Prohibited Content (HARD BLOCKS)
+
+**❌ ABSOLUTELY FORBIDDEN:**
+
+- Real people's names, faces, or likeness without consent
+- Celebrity/politician/public figure references
+- Actual brand names, logos, trademarks (use generic equivalents)
+- Graphic depictions of injuries, blood, gore, death
+- Sexually explicit or suggestive content
+- Content involving minors in unsafe contexts
+- Hate speech, discriminatory language, slurs
+- Self-harm, suicide, dangerous challenges
+- Copyright-protected characters, franchises, IP
+
+---
+
+## Safe Framing for Historical/Military Content
+
+**MANDATORY Auto-Injection for War/Military Scenes:**
+
+```
+Historical reenactment style. Documentary approach. Non-graphic representation.
+No injuries shown, no blood, no gore. Educational context.
+Focus on scale, atmosphere, and environmental storytelling.
+Equipment shown in static/display context. No active violence.
+```
+
+### Safe Substitution Examples
+
+| User Request | UNSAFE (Blocked) | SAFE Alternative (Passes) |
+|--------------|------------------|---------------------------|
+| "Battle scene" | Soldiers killing each other | "Historical military formation, distant wide shot, atmospheric smoke, intensity/scale focus" |
+| "Shooting gun" | Gun pointing at camera/victim | "Side profile of soldier recoil, muzzle flash, shell casing ejection, mechanical focus" |
+| "Explosion" | Destruction/Gore | "Volumetric smoke plume, dramatic lighting, shockwave ripple, debris in air (no bodies)" |
+| "Ship hit" | Victims dying | "Naval vessel listing, heavy smoke, distant silhouette, environmental impact" |
+
+---
+
+## 🌪️ DISASTER & KINETIC ACTION PROTOCOLS
+
+### General Disaster Safety (Earthquake, Flood, Fire)
+
+**Rule:** Focus on **Environmental Power** vs. **Human Resilience**. Never show graphic suffering.
+
+1. **Earthquake:** Show shaking objects, dust rising, structures swaying. *Avoid:* People being crushed.
+2. **Flood:** Show rushing water, rising levels, submerged objects. *Avoid:* Drowning victims.
+3. **Fire:** Show towering flames, smoke, firefighters working. *Avoid:* Burning bodies.
+
+**Safe Prompting Strategy:**
+"Cinematic wide shot of [disaster force], overwhelming scale, dust/smoke/water filling the frame. High contrast lighting. Focus on the raw power of nature."
+
+### Gunfire & Weapon Safety ("Ateş Etme")
+
+**Rule:** Never show the "moment of impact" on a human body.
+
+- **Option A (The Shooter):** Focus on the recoil, the intense expression, the muzzle flash.
+- **Option B (The Impact):** Show the *environment* reacting (wood splintering, dirt kicking up) OR the *aftermath* (falling ground).
+- **NEVER:** Show bullet entering flesh or blood spurting (Instant Block).
+
+**Safe Phrasing:**
+- "Mechanical operation of weapon"
+- "Muzzle flash illuminating face"
+- "Heavy recoil"
+- "Shell casing flying"
+
+---
+
+## Audio Safety
+
+- Never script dialogue involving threats, violence, hate speech
+- If minors on screen: "Dialogue transcript: NONE" (platform requirement)
+- Weapon sounds: "mechanical operation" not "firing at targets"
+- No copyrighted music references
+
+---
+
+## Turkish Historical Content Guidelines
+
+For Ottoman/Turkish historical scenarios:
+
+### Safe Character Descriptions
+
+| Character Type | Safe Description |
+|----------------|------------------|
+| **Ottoman Officer** | "Distinguished military officer, ornate uniform, medals, commanding presence" |
+| **Turkish Soldier (WWI)** | "Young soldier, mustached, wearing red fez and Ottoman military uniform" |
+| **Navy Admiral** | "Senior naval officer, formal uniform, weathered face, standing on bridge" |
+| **Artillery Crew** | "Soldiers operating cannon, period uniforms, focused expressions" |
+
+### Safe Battle Framing
+
+- Focus on **equipment**, **atmosphere**, **human determination**
+- Wide shots for scale, close-ups for emotion
+- Smoke, fire as environmental elements (not destruction)
+- Document the **effort**, not the **violence**
+
+---
+
+## Priority Enforcement
+
+**P0 (Safety Override):** Platform compliance > everything else
+
+If any safety check fails:
+1. STOP generation
+2. Revise prompt
+3. Verify compliance
+4. Then proceed
+
+---
+
+> **Remember:** Every prompt must pass safety checks. When in doubt, reframe. Never risk platform rejection for a single word.