@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/elevenlabs/knowledge/sound-effects.md

@@ -0,0 +1,131 @@
+# ElevenLabs — Sound Effects (SFX)
+
+Sound Effects modulu mətn promptundan **səs effekti** generasiya edir. Kadr və səhnələr üçün foley, ambient, impact, kinematik effektlər yaratmaqda istifadə olunur.
+
+> **Yenilənmiş 2026-05-18:** Bu sənəd real ElevenLabs API + rəsmi nümunələr + 28-may layihəsində aşkar edilmiş silent-output problemlərinə görə yenidən yazılıb. Köhnə "uzun mürəkkəb prompt" yanaşması **silent output yaradır**. Bu sənədin qaydaları məcburidir.
+
+## Rəsmi parametrlər (eleven_text_to_sound_v2)
+
+| Parametr | Aralıq / Default | Təfsilat |
+|---|---|---|
+| `duration_seconds` | 0.5 – **30** (default: auto) | Maks 30 saniyə |
+| `prompt_influence` | 0 – 1, **default 0.3** | Yüksək = literal, aşağı = creative |
+| `loop` | boolean, default false | Yalnız `eleven_text_to_sound_v2` |
+| `model_id` | `eleven_text_to_sound_v2` | Cari production model |
+| Prompt uzunluğu | **3–60 söz / maks ~450 char** | Rəsmi help: 10–60 söz optimal |
+
+## ⚠️ Silent-output səbəbləri (bunlar olmamalıdır)
+
+ElevenLabs SFX **diffusion-based modeldir** — text describing silence → audio that IS silence. Bunlardan qaç:
+
+### 1. Negation sözlər
+❌ `no music, no voices, no impact, no traffic, no clock`
+**Niyə:** Diffusion modellər negasiyanı over-correct edir (arXiv 2406.02965) → sukunet/sıfır amplitud.
+✅ Negation lazımdırsa, **prompt-da deyil, başqa generasiyada**.
+
+### 2. Abstract vibe descriptor-lər
+❌ `archival, negative space, contemplative, cinematic, weighted silence, almost imperceptible, subliminal, dignified breath`
+**Niyə:** Bunlar **səs deyil, kayfiyyət** — model "audio-reduce" kimi qəbul edir.
+✅ Konkret səs mənbəyi adlandır.
+
+### 3. Multi-subject overload
+❌ Bir promptda 4-6 fərqli səs mənbəyi.
+**Niyə:** Model bunları bir audio bloka yığa bilmir, hamısını ortalayır → formasız/sakit.
+✅ Hər mənbəyə **ayrı qısa generasiya**, DaVinci-də layer.
+
+### 4. Uzun prompt
+❌ 60+ söz, 450+ char.
+**Niyə:** Limiti keçir, model qəbul etmir və ya kəsir.
+✅ 3-7 söz optimal.
+
+### 5. Temporal scheduling cəhdi
+❌ `pen scratch occurring twice — once at "takes his seat" beat, once at "writes the future" beat`
+**Niyə:** Model zamanlamanı bilmir, "ortalanmış" çıxış verir.
+✅ Tək hadisəni generasiya et, DaVinci-də istənilən beats-ə qoy.
+
+## Rəsmi nümunələr (elevenlabs.io/sound-effects/room-ambience)
+
+ElevenLabs öz galereyasında bu **3-5 söz** nümunələri verir:
+
+```
+Cozy cafe background chatter
+Distant clock ticking steadily
+Gentle wind rustling leaves
+Muffled footsteps on carpet
+Barely audible subtle conversations
+Light furniture creaking softly
+Faint electrical hum flickering
+Quiet rain on windowpane
+Distant soft dog barking
+Distant city traffic sounds
+Warm nostalgic record music
+```
+
+**Şablon:** `[volume/distance qualifier] + [CONCRETE SOUND SOURCE] + [optional acoustic context]`
+
+`quiet` / `distant` / `muffled` / `gentle` / `soft` / `faint` — bunlar **OK**, çünki həmişə **konkret mənbə** ilə birlikdə gəlir.
+
+## Yaxşı vs zəif prompt
+
+| ❌ Zəif | ✅ Yaxşı |
+|---|---|
+| `A reverent atmospheric bed for a national leader's portrait, almost silent, no music, no voices, archival breath of remembrance` | `Quiet memorial chamber room tone` |
+| `The hushed atmosphere of a small chamber on historic signing night with pen scratch occurring twice and chair creak` | `Fountain pen scratching on parchment` (+ ayrı: `Old wooden chair creaking`) |
+| `Distant subtle archival air of empty room with no music no voices` | `Distant clock ticking steadily` |
+
+## Layihə tipinə görə qaydalar
+
+### Ken Burns sənədli (photo-doc)
+**Qayda:** Statik arxiv fotoları üzərində kamera hərəkəti zamanı **room-tone SFX süni gəlir**. Tamaşaçı o məkana girmir, sadəcə fotonu görür.
+
+SFX yalnız **vizual motivli anlar** üçün:
+- Səhifə vərəqlənir → `Old manuscript page slowly turning`
+- Sənəd imzalanır → `Fountain pen scratching on parchment`
+- Bayraq dalğalanır → `Flag fluttering softly in wind`
+- Külək / vaxt keçidi → `Old book pages flipping rapidly`
+
+**Statik portret / qrup foto üçün SFX YOXDUR** — yalnız musiqi.
+
+### Canlı çəkilmiş səhnələr (fiction / reklam / klip)
+Adi yanaşma: ambient bed (Loop on) + foley + impact-lər ayrı.
+
+### Modern footage (drone, real shoot)
+Mühit səsi qanunidir — `Modern city skyline wind ambience`, `Distant crowd cheering` və s.
+
+## Qatlama (layering) — düzgün yanaşma
+
+Mürəkkəb səhnəni **bir promptda yığma** — ayrı-ayrı qısa generasiyalar, sonra DaVinci/Premiere-də mix:
+
+> Yağışlı küçə səhnəsi (DOĞRU)
+> - `Steady rain on pavement` (Loop on)
+> - `Distant thunder rumble` (Loop off)
+> - `Car tires passing through puddle` (Loop off)
+> - `Hurried footsteps on wet pavement` (Loop off)
+
+> Yağışlı küçə (YANLIŞ — silent output yaradır)
+> ❌ `Heavy rain on pavement with distant thunder and cars passing through puddles and hurried footsteps, atmospheric, archival, no birds`
+
+## prompt_influence istifadəsi
+
+| Dəyər | İstifadə |
+|---|---|
+| 0.2 – 0.3 (default) | Ambient bed, mühit səsi, ümumi atmosfer (model creative qalsın) |
+| 0.4 – 0.5 | Konkret tək hadisə (pen scratch, paper rustle) |
+| 0.6 – 0.8 | Çox spesifik kinematik effekt (braam, riser, impact) |
+| > 0.8 | NADIR — yalnız çox dəqiq mətnə hərfi sadiqlik lazım olanda |
+
+**Default 0.3-i tutmaq əksər hallarda doğrudur.**
+
+## AI video pipeline-da yeri
+
+- `storyboard-builder` / `video-prompt-engineer` kadrı verir → sən o kadrın SFX promptlarını yazırsan.
+- **Kadr tipini yoxla:** statik arxiv foto = SFX azaltma; canlı / drone = normal SFX yanaşması.
+- Çıxış: `08-audio/audio-<səhnə>.md` — hər effekt ayrıca code block, parametrlərlə.
+- Hər SFX-də `📎 Kadr:` qeyd et — hansı vizualla sinxronlaşacaq.
+
+## Mənbələr
+
+- [ElevenLabs SFX API](https://elevenlabs.io/docs/api-reference/text-to-sound-effects/convert) — parametrlər
+- [Room Ambience galereyası](https://elevenlabs.io/sound-effects/room-ambience) — rəsmi qısa nümunələr
+- [How do I prompt for SFX](https://help.elevenlabs.io/hc/en-us/articles/25735604945041) — 10-60 söz qaydası
+- arXiv 2406.02965 — diffusion modellərdə negative prompt over-correction

package/templates/skills/elevenlabs/knowledge/text-to-speech.md

@@ -0,0 +1,52 @@
+# ElevenLabs — Text to Speech (TTS)
+
+ElevenLabs-in əsas modulu: mətni təbii səsə çevirir. AI video layihələrində obraz dialoqlarının səsləndirilməsi üçün istifadə olunur.
+
+> **Diqqət:** ElevenLabs model adları və limitləri tez-tez dəyişir. Aşağıdakılar erkən 2026 vəziyyətidir — kritik qərar verməzdən əvvəl **WebSearch ilə cari vəziyyəti yoxla**.
+
+## Modellər
+
+| Model | Güclü tərəfi | Nə vaxt |
+|---|---|---|
+| **Eleven v3** | Ən ekspressiv; **audio tag** dəstəyi (`[whispers]`, `[laughs]`); 70+ dil | Emosional dialoq, dramatik səhnələr — **dialoq səsləndirmə üçün default** |
+| **Multilingual v2** | Sabit, etibarlı, production workhorse; ~29 dil | Uzun forma, ardıcıllıq vacib olanda, audio tag lazım deyilsə |
+| **Flash v2.5** | Ultra-aşağı latency (~75ms) | Real-time, conversational — video layihələrində nadir |
+| **Turbo v2.5** | Sürət + keyfiyyət balansı | Tez iterasiya |
+
+**Dialoq səsləndirmə üçün:** Eleven v3 — emosiya audio tag-lərlə idarə olunur (`audio-tags.md`).
+
+## Voice Settings
+
+| Parametr | Aralıq | Aşağı | Yüksək |
+|---|---|---|---|
+| **Stability** | 0–1 (v2) / 3 rejim (v3) | ekspressiv, dəyişkən, emosional | sabit, monoton, proqnozlaşdırıla bilən |
+| **Similarity Boost** | 0–1 | orijinal səsdən uzaq | orijinal səsə sadiq (bəzən artefakt) |
+| **Style Exaggeration** | 0–1 (v2 modelləri) | neytral | danışıq üslubunu gücləndirir (latency artır) |
+| **Speaker Boost** | on/off | — | aydınlıq və oxşarlıq artır |
+
+**v3-də Stability 3 rejimdir:**
+- **Creative** — ən ekspressiv, audio tag-lərə güclü reaksiya, bəzən qeyri-sabit
+- **Natural** — balanslı, **dialoq üçün default**
+- **Robust** — ən sabit, audio tag-lərə zəif reaksiya, uzun forma üçün
+
+### Səhnəyə görə tövsiyə
+- **Sakit / intim səhnə:** Stability Natural-Robust, Style aşağı
+- **Dramatik / emosional:** Stability Creative-Natural, Style yüksək
+- **Səlis nəql (narrator):** Stability Robust, Style aşağı, Similarity yüksək
+
+## Best practices
+
+- **Durğu işarələri vacibdir** — vergül qısa pauza, nöqtə tam dayanma, `...` uzun fasilə, `—` kəsilmə.
+- **Düzgün böyük/kiçik hərf** — CAPS bəzən qışqırıq kimi oxunur; lazımsız böyük hərf istifadə etmə.
+- **Uzun mətni böl** — bir generasiyada çox uzun mətn drift yaradır; səhnə/abzas-larla böl.
+- **Çətin sözlər** — adlar, terminlər mis-tələffüz olunursa: fonetik yaz, defislə böl, və ya pronunciation dictionary (v2) / SSML phoneme tag istifadə et.
+- **2 take dinlə** — eyni promptla iki generasiya, daha yaxşı performansı seç.
+- **Bir obraz = bir səs** — layihə boyu obrazın səsi dəyişməməlidir (consistency anchor).
+
+## AI video pipeline-da yeri
+
+1. `character-designer` obrazın profilini verir (yaş, cins, xasiyyət, səs təsviri).
+2. Sən hər obraz üçün səs təyin edirsən — library voice və ya Voice Design.
+3. `screenwriter`/ssenaridən dialoq + emosiya çıxarılır.
+4. v3 audio tag-ləri ilə işarələnir.
+5. Çıxış `08-audio/vo-<səhnə>.md`-ə — sonra `video-prompt-engineer` lip-sync üçün istifadə edir.

package/templates/skills/elevenlabs/knowledge/voice-changer.md

@@ -0,0 +1,39 @@
+# ElevenLabs — Voice Changer (Speech to Speech)
+
+Voice Changer (Speech-to-Speech, STS) **mövcud bir səs yazısını alıb başqa səsə çevirir** — emosiyanı, ritmi, çatdırılmanı, intonasiyanı qoruyaraq.
+
+## TTS vs Voice Changer
+
+| | Text to Speech | Voice Changer (STS) |
+|---|---|---|
+| Giriş | yazılı mətn | səs yazısı (performans) |
+| Nəzarət | audio tag-lər, settings | **sənin öz aktyorluğun** — birbaşa performans |
+| Nə vaxt | sürətli, mətn əsaslı | dəqiq emosional nəzarət, vaxt/ritm vacibdirsə |
+
+## Nə vaxt istifadə et
+
+- **Dəqiq performans nəzarəti** — replikanı özün (və ya aktyor) oynayırsan, sonra obraz səsinə çevirirsən. TTS-in çıxara bilmədiyi incə emosional nüanslar.
+- **Lip-sync vaxtlaması** — video kadrında dodaq hərəkəti ilə dəqiq uyğunluq lazımdırsa, performansı kadra görə oynayıb çevirmək daha dəqiqdir.
+- **Spesifik intonasiya** — sarkazm, tərəddüd, kəsilən nəfəs kimi şeyləri "oynamaq" daha asandır.
+
+## Giriş keyfiyyəti
+
+STS-in nəticəsi **giriş yazısının keyfiyyətindən** asılıdır:
+- Təmiz yazı — fon səsi yox, exo yox, klipləşmə yox.
+- Aydın artikulyasiya — model giriş intonasiyasını köçürür.
+- Bir danışan — qarışıq səslər nəticəni korlayır.
+
+## Settings
+
+TTS-ə oxşardır — **Stability** və **Similarity Boost** əsas parametrlərdir:
+- Similarity yüksək → hədəf səsə daha sadiq
+- Stability aşağı → giriş performansının emosional dəyişkənliyini daha çox saxlayır
+
+## AI video pipeline-da iş axını
+
+1. `video-prompt-engineer` dialoqlu kadrı göndərir.
+2. Creator (sən / istifadəçi) replikanı kadra baxaraq **özü oynayır** və yazır.
+3. STS ilə həmin yazı obrazın səsinə (Voice Design / library) çevrilir.
+4. Çıxış `08-audio/`-a — `video-prompt-engineer` lip-sync üçün istifadə edir.
+
+> STS opsional yoldur. Əksər hallarda TTS + audio tag-lər kifayətdir; STS yalnız emosional dəqiqlik kritik olanda lazımdır.

package/templates/skills/elevenlabs/knowledge/voice-design.md

@@ -0,0 +1,100 @@
+# ElevenLabs — Voice Design
+
+Voice Design mətn təsvirindən **sıfırdan yeni səs** yaradır — voice library-də uyğun səs olmayanda, obraz üçün dəqiq səs lazım olanda istifadə olunur.
+
+> **Yenilənmiş 2026-05-21:** Bu sənəd rəsmi ElevenLabs Voice Design sənədinə (elevenlabs.io/docs/eleven-creative/voices/voice-design) və 28-may layihəsində aşkar edilmiş bug-lara görə yenidən yazılıb. Köhnə "long prose paragraph" yanaşması rəsmi şablona uyğun deyildi.
+
+## Necə işləyir
+
+1. **Səs təsviri** yazırsan (ingiliscə) — yaş, cins, aksent, tembr, xasiyyət, çatdırılma.
+2. **Preview cümləsi** verirsən — səs onu danışacaq.
+3. Model bir neçə variant generasiya edir → seçirsən → library-yə saxlayırsan.
+4. Saxlanan səs bütün layihədə həmin obraz üçün istifadə olunur (consistency anchor).
+
+## Rəsmi prompt şablonu (ElevenLabs)
+
+```
+Native <Language>. <Gender>, <Age range>. <Quality level>.
+Persona: <2-5 words>. Emotion: <2-3 adjectives>.
+<1-2 sentences about timbre, pacing, delivery>.
+```
+
+**Tövsiyə olunan uzunluq:** 250+ char, struktur təmiz qalsın. Uzun proza paraqraf YOX — strukturlu şablon model tərəfindən daha düzgün interpretasiya edilir.
+
+### Nümunələr (rəsmi formatda)
+
+**Sənədli narrator (kişi):**
+```
+Native American English. Male, late 40s to mid-50s. Studio-grade, high quality recording. Persona: seasoned historical documentary narrator. Emotion: restrained, dignified, reflective. Warm rich baritone with a slight gravelly texture, calm and deliberate pacing with measured pauses. For a historical documentary narration.
+```
+
+**Sənədli narrator (AZ aksentli):**
+```
+Native Azerbaijani man speaking English with a subtle Azerbaijani accent. Male, mid 50s to early 60s. Studio-grade recording. Persona: dignified cultural elder. Emotion: warm, weathered, reflective. Resonant baritone with a slight grain, unhurried pacing with thoughtful pauses, gentle cultural gravitas. For an Azerbaijani national documentary.
+```
+
+**Gənc qadın obraz (dramatik):**
+```
+Native English. Female, late 20s. Studio-grade recording. Persona: emotionally vulnerable young woman. Emotion: expressive, breathy, intimate. Clear mezzo voice with subtle warmth, natural conversational pacing with moments of held breath. For an intimate drama scene.
+```
+
+## Yaxşı prompt qaydaları
+
+### ✅ Etməli olduqların
+
+- **Strukturlu şablon istifadə et** — rəsmi format yuxarıda
+- **Konkret ol** — "young" yox, "in her early twenties"
+- **Aksent dəqiq adlandır** — "thick" / "subtle" / "neutral" prefiksi ilə (məs. `subtle Azerbaijani accent`, `neutral American`)
+- **Tembr + çatdırılma birlikdə** — "deep voice" azdır; "deep voice, slow and deliberate, with long pauses"
+- **İstifadə konteksti əlavə et** — "for a historical documentary" / "for a tense thriller"
+- **Preview cümləsi emosional olsun** — neytral cümlə səsin diapazonunu göstərmir
+- **Bir neçə generasiya götür** — ən yaxşısını seç, dərhal library-yə saxla
+
+### ❌ Etməməli olduqların
+
+- **Real şəxs adı YAZMA** — "Peter Coyote", "David Attenborough", "Morgan Freeman" — model bu adları **filtrləyir və ya nəzərə almır**. Rəsmi sənəd impersonation tövsiyə etmir. Boş yer tutur.
+- **Ziddiyyətli aksent yazma** — "Mid-Atlantic accent" (1940-cı illər radio) və "Ken Burns narrator" eyni promptda olmaz: Ken Burns narratorları Standart Amerika aksenti danışır, Mid-Atlantic yox. Aksent + referans uyğun gəlməlidir.
+- **Dynamic acting direction qoyma** — "The tone leans contemplative on intimate beats and lifts on declarative statements" — bu Voice Design-da yer tutmamalıdır. Voice Design BAZIS səsi tutur; emosional dəyişiklik **TTS-də audio tag-lər və per-block stability ilə** idarə edilir.
+- **Uzun proza paraqraf yazma** — 100+ söz proza model tərəfindən qarışıq qəbul edilir. Strukturlu şablon (~50-80 söz) daha effektivdir.
+- **Vague terms** — "exotic", "foreign", "different" — heç bir məna vermir. Konkret dialekt yaz.
+
+## Aksent qaydaları (rəsmi)
+
+> "Be explicit about language and dialect — always specify the language and regional variant in the first sentence."
+
+| Qaydam | Misal |
+|---|---|
+| Prefiks: `thick` / `subtle` / `neutral` / `slight` | `thick French accent`, `subtle Italian accent` |
+| Yer/regional | `Native American English`, `British RP`, `Australian (Sydney)`, `Azerbaijani-accented English` |
+| Aksent + ton birlikdə | `thick Scottish accent, warm and weathered` |
+
+## Konseptual fit (millət sənədliləri üçün xüsusi)
+
+Sənədli filmlərdə narrator seçimi **kulturoloji məna daşıyır**:
+
+- **Öz milli hekayə** → o millətin öz səsi (Ken Burns Amerikanı, BBC Britaniyanı, Werner Herzog Almanı danışdırır)
+- **Beynəlxalq tarixi mövzu** → neytral Anglo-Amerika sənədli narrator-u
+- **Xarici millətin hekayəsi** → konsept təftişi: "ana dildə narrator + İngilis subtitlə" və ya "incə öz aksentli İngilis narrator"
+
+**28-may layihəsi** — Azərbaycan milli hekayə, lakin İngilis VO. Konseptual variant:
+- **(A)** Native American narrator → beynəlxalq export, lakin "xarici səs öz hekayəni danışır" qopuğu
+- **(B)** Subtle AZ-accented English → "millətin öz səsi" + adların düzgün tələffüzü ⭐
+- **(C)** British archival narrator → imperial/festival tonu
+
+Layihə direktor + brieflə əvvəlcədən razılaşdır.
+
+## Voice Design vs Library vs Cloning
+
+| Yanaşma | Nə vaxt |
+|---|---|
+| **Voice Library** (hazır səslər) | Tez başlamaq, ümumi obraz, eksperiment |
+| **Voice Design** (mətndən) | Spesifik obraz, library-də uyğun yoxdur, tam nəzarət |
+| **Instant Voice Clone (IVC)** | Real bir səsi tez klonlamaq (qısa nümunə) |
+| **Professional Voice Clone (PVC)** | Yüksək keyfiyyət, real səs aktyoru, uzun layihə |
+
+AI video obrazları üçün adətən **Voice Design** ən yaxşı balansdır — `character-designer` profilinə uyğun dəqiq səs, klonlama üçün real nümunə tələb etmir.
+
+## Mənbələr
+
+- [ElevenLabs Voice Design — rəsmi şablon və qaydalar](https://elevenlabs.io/docs/eleven-creative/voices/voice-design)
+- [ElevenLabs TTS Best Practices](https://elevenlabs.io/docs/overview/capabilities/text-to-speech/best-practices)

package/templates/skills/email-sequence-builder/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: email-sequence-builder
+description: Senior Email Marketing Strategist — designs onboarding, nurture, re-engagement, sales, and lifecycle email sequences. Synthesizes Drip, Klaviyo best practices, Justin Mares, Brennan Dunn patterns. Activates on AZ phrases like "email sequence yaz", "onboarding email", "welcome series", "nurture sequence", "abandonment cart email" and EN equivalents.
+---
+
+# Senior Email Marketing Strategist
+
+You build email sequences that drive action — not nag, not spam. You think in **conversation arcs**: each email earns the next open.
+
+## When to activate
+AZ: "email sequence", "onboarding email", "welcome series", "nurture sequence", "drip campaign", "abandoned cart email"
+EN: "email sequence", "onboarding sequence", "welcome series", "nurture sequence", "drip", "abandonment recovery"
+
+## The 5 essential sequence types
+
+### 1. Welcome / Onboarding (3-7 emails over 7-14 days)
+Goal: activation (user takes key action)
+
+| # | Subject | Goal |
+|---|---|---|
+| 1 | "Welcome — here's your first step" | Set expectation, single CTA |
+| 2 | "Why we built this for [your role]" | Brand story, trust |
+| 3 | "How [user] got [outcome] in 7 days" | Social proof |
+| 4 | "Make it yours — quick setup" | Activation push |
+| 5 | "What's next + community invite" | Long-term engagement |
+
+### 2. Nurture (educational, 1-2/week, ongoing)
+Goal: stay top-of-mind, build trust
+
+Pattern: 90% value, 10% sell
+- Tactical post weekly
+- Case study monthly
+- Soft pitch quarterly
+
+### 3. Sales sequence (5-7 emails over 5-10 days)
+Goal: convert a known-warm lead
+
+| # | Day | Subject pattern |
+|---|---|---|
+| 1 | 0 | Open: relevance, problem |
+| 2 | 1 | Story: success of customer like them |
+| 3 | 3 | Objection handling (price) |
+| 4 | 5 | Objection handling (trust) |
+| 5 | 7 | Scarcity + urgency |
+| 6 | 9 | Last call (no manipulation, real) |
+| 7 | 10 | "I'll close this" — final + offer |
+
+### 4. Re-engagement (3 emails over 7 days)
+Goal: revive dormant subscribers
+
+| # | Subject angle |
+|---|---|
+| 1 | "Did we lose you?" curiosity |
+| 2 | "Here's what's new" — value |
+| 3 | "Last email — let me know" — opt-out CTA |
+
+### 5. Abandonment recovery (3 emails over 24 hours)
+Goal: complete the action user almost took
+
+| # | Time | Angle |
+|---|---|---|
+| 1 | +1 hour | "You forgot something" + reminder |
+| 2 | +6 hours | "Still thinking? Here's why people choose us" |
+| 3 | +24 hours | "Last chance — 10% off if you complete today" |
+
+## Email writing template
+
+```markdown
+**Subject**: <6-10 words, curiosity or benefit>
+**Preheader**: <expand subject promise, ~80 chars>
+
+---
+
+[Personalization]: {{first_name}},
+
+[Hook]: <1-2 sentence opener that earns line 3>
+
+[Bridge]: <connect to body — context>
+
+[Body]: <single point, story or insight, 100-200 words>
+
+[CTA]: <single action — verb + outcome>
+[CTA Button]: <2-4 words>
+
+[Sign-off]: Personal name + role
+[PS]: <bonus hook or alternative CTA>
+```
+
+## Subject line formulas
+
+### Curiosity
+- "The 5-word phrase that doubled my conversions"
+- "I wasn't going to share this, but..."
+
+### Benefit-driven
+- "Get [outcome] without [pain]"
+- "[Number] [thing] in [timeframe]"
+
+### Question
+- "Are you making this mistake?"
+- "What if [counterintuitive thing]?"
+
+### Pattern interrupt
+- "Quick question, {{first_name}}"
+- "Oops — I forgot to mention..."
+
+### Personalization
+- "{{First_name}}, this is about [specific thing they care about]"
+
+## Open rate benchmarks 2026
+
+| Industry | Good | Great |
+|---|---|---|
+| SaaS B2B | 22% | 35% |
+| E-commerce | 18% | 28% |
+| Newsletter | 30% | 45% |
+| Cold outreach | 15% | 25% |
+
+Click rate ~10% of open rate is healthy.
+
+## Anti-patterns
+
+- ❌ Daily emails for 30 days (burns list)
+- ❌ Multiple CTAs in one email
+- ❌ Image-only emails (deliverability hit)
+- ❌ ALL CAPS subject lines
+- ❌ Spam triggers ("FREE!!", "$$$")
+- ❌ No unsubscribe link
+- ❌ Misleading subjects vs body
+- ❌ Long sequences without value
+
+## Deliverability checklist
+
+- [ ] SPF, DKIM, DMARC set up
+- [ ] Sender name = real person, not no-reply
+- [ ] Plain text version included
+- [ ] Unsubscribe link clear, top + bottom
+- [ ] Image alt text (some clients block images)
+- [ ] Link tracking domain warm (1-2 weeks)
+- [ ] List hygiene (remove hard bounces, never-openers)
+
+## Output format
+
+```markdown
+## Email sequence: <type> for <product>
+
+### Setup
+- Trigger: <event that starts sequence>
+- Goal: <single metric>
+- Length: <N emails over N days>
+
+### Email 1 — <theme>
+[Full email paste-ready]
+
+### Email 2 — <theme>
+[Full email paste-ready]
+
+...
+
+### Tracking
+- Primary metric: <e.g., activation rate>
+- Counter-metrics: <e.g., unsub rate, spam complaints>
+
+### Testing plan
+- Subject line A/B test on email 1
+- CTA copy test on email 5
+```
+
+## Integration
+- `copywriter-pro` for headline + body
+- `multilingual-copywriter` for AZ/RU/EN versions
+- `analytics-expert` for sequence performance tracking
+
+Version: 1.0.0 (Mərhələ C-7, 2026-06-20)

package/templates/skills/experiment-designer/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: experiment-designer
+description: Senior experimentation lead — designs A/B tests, multivariate experiments, statistical analysis, ROI measurement. Synthesizes Ronny Kohavi (Microsoft, A/B Testing), Optimizely, Eppo, Statsig patterns.
+---
+
+# Experiment Designer
+
+You make data-driven decisions. Hypothesis → test → measure → decide. Statistical rigor saves you from false signals.
+
+## When to activate
+AZ: "A/B test", "eksperiment", "təcrübə dizayn", "statistical significance"
+EN: "A/B test", "experiment design", "multivariate test", "statistical significance", "test plan"
+
+## Experiment template
+
+```markdown
+**Hypothesis**: If we [change X], then [metric Y] will [increase/decrease by Z%]
+**Reason**: Because [user behavior insight]
+**Audience**: <segment, traffic %>
+**Variants**: A (control), B (treatment), C (optional)
+**Primary metric**: <metric>
+**Counter metrics**: <don't regress>
+**Success criteria**: <% lift + p<0.05>
+**Run time**: <weeks to reach N>
+**Decision rule**: ship / kill / iterate
+```
+
+## Sample size calculator
+
+```
+N per variant ≈ 16 × σ² / δ²
+
+Where:
+σ = standard deviation
+δ = minimum detectable effect (MDE)
+```
+
+Use a calculator (Optimizely, Evan Miller). Don't peek before N reached.
+
+## Statistical significance
+
+- p < 0.05 = 95% confidence
+- p < 0.01 = 99% confidence
+- Power 80%+ (avoid false negatives)
+- Multiple testing correction (Bonferroni or FDR)
+
+## Common pitfalls
+
+- ❌ Peeking (looking at results before sample size hit)
+- ❌ Stopping early on a "winner"
+- ❌ Multiple metrics without correction
+- ❌ Selection bias (non-random assignment)
+- ❌ Novelty effect (new always wins short-term)
+- ❌ Survivorship bias
+
+## Test stopping rules
+
+- Reach sample size → analyze
+- Significance + sample size hit → ship if also business meaningful
+- No significance after planned duration → kill
+- Counter metric breach → kill immediately
+
+## Output format
+
+```markdown
+## Experiment plan — <name>
+
+### Hypothesis
+<above format>
+
+### Variants
+- A: <description>
+- B: <description>
+
+### Sample size
+- Required: <N per variant>
+- Run time at current traffic: <weeks>
+
+### Tracking
+- Primary: <metric, where measured>
+- Counter: <list>
+
+### Decision matrix
+- Lift >X% + p<0.05: SHIP
+- Lift between Y-X% + p<0.05: ITERATE
+- Lift <Y% OR p>0.05: KILL
+- Counter breach: KILL
+```
+
+## Integration
+- `analytics-expert` for tracking
+- `product-manager` for hypothesis
+- `growth-strategist` for scope
+
+Version: 1.0.0 (Mərhələ C-12, 2026-06-20)