code-ai-installer 3.0.0 → 4.0.0

package/domains/content/locales/en/.agents/skills/storytelling-framework/SKILL.md

@@ -1,400 +1,400 @@
----
-name: storytelling-framework
-description: Storytelling frameworks — 10 frameworks, Decision Tree, emotional arc, platform adaptation, examples
----
-# Storytelling Framework
-
-## When to Use
-- When creating **narrative content** — articles, long posts, emails, video scripts, case studies.
-- For **promotional content** — landing pages, promos, offers.
-- For **engaging content** — personal stories, behind the scenes, transformations.
-- As part of the **`$content-brief`** — to select a narrative structure for a specific piece of content.
-
-## Input
-
-| Field | Required | Description |
-|-------|:--------:|-------------|
-| Content Goal | ✅ | Persuade / inspire / educate / entertain / sell |
-| Audience Persona | ✅ | From `$audience-analysis` — pain points, triggers, language |
-| Platform | ✅ | Determines the length and depth of the narrative |
-| Content Type | ✅ | Post / article / email / reel / landing page / case study / video |
-| Key Data / Facts | ⬚ | From `$topic-research` / `$data-storytelling` — if data-driven |
-| Product / Offer | ⬚ | If promotional content — what is being promoted |
-
-> If the goal is not specified — **request it**. A framework without a goal equals a random choice.
-
-## Decision Tree — Framework Selection
-
-| Goal | Content Type | Recommended Frameworks |
-|------|--------------|------------------------|
-| **Sell** (conversion) | Landing, promo, email | PAS, PASTOR, AIDA, FAB |
-| **Persuade** (opinion) | Post, article, LinkedIn | BAB, PAS, StoryBrand |
-| **Educate** (know-how) | Carousel, article, video | 4P, STAR, How-to (AIDA adaptation) |
-| **Inspire** (motivation) | Post, reel, email | Hero's Journey, BAB, Pixar Formula |
-| **Case Study** (result) | Post, article, video | STAR, BAB, Hero's Journey |
-| **Entertain** (engagement) | Reel, post, TikTok | Pixar Formula, Open Loop |
-
-> Select **1 framework** for each piece of content. Do not mix them.
-
-## Frameworks
-
-### 1. PAS — Problem → Agitate → Solution
-
-**Essence:** Highlight the problem, agitate the pain point, provide the solution.
-**Best for:** Promotional, MOFU/BOFU, email, landing pages.
-
-| Stage | What it does | Emotional Arc |
-|-------|--------------|---------------|
-| **P — Problem** | Describe a problem relatable to the audience | Recognition: "this is about me" |
-| **A — Agitate** | Intensify the pain: what happens if not resolved? Consequences | Tension: anxiety, frustration |
-| **S — Solution** | Present the solution (product/method) + CTA | Relief: "this is how to fix it" |
-
-**Example (Instagram, email marketing):**
-> **P:** Spending 3 hours on one email blast?
-> **A:** While you manually compile emails, competitors have automated the whole process. Every day of delay means lost leads.
-> **S:** [Product] lets you build an email campaign in 15 minutes. Try it for free →
-
----
-
-### 2. AIDA — Attention → Interest → Desire → Action
-
-**Essence:** The classic advertising funnel within a single text.
-**Best for:** Ads, promos, landing pages.
-
-| Stage | What it does | Emotional Arc |
-|-------|--------------|---------------|
-| **A — Attention** | Hook — grab attention | Curiosity |
-| **I — Interest** | Why this is important for the reader | Interest: "tell me more" |
-| **D — Desire** | Benefits, transformation, social proof | Desire: "I want this too" |
-| **A — Action** | Specific CTA | Resolution: "I'm doing this now" |
-
-**Example (SaaS landing page):**
-> **A:** 87% of marketers spend over 5 hours a week scheduling content manually.
-> **I:** What if AI could do it for you — and do it better?
-> **D:** [Product] creates content plans, writes texts, and publishes on schedule. Over 500 companies have already switched.
-> **A:** Start your 14-day free trial →
-
----
-
-### 3. BAB — Before → After → Bridge
-
-**Essence:** Show the "before/after" contrast and the bridge on how to get there.
-**Best for:** Case studies, motivational posts, transformation, LinkedIn.
-
-| Stage | What it does | Emotional Arc |
-|-------|--------------|---------------|
-| **Before** | The "before" situation — pain, problem | Recognition |
-| **After** | The "after" situation — result, dream | Inspiration: "I want to be there" |
-| **Bridge** | How to cross from Before to After (product/method/action) | Decision: "here is my path" |
-
-**Example (LinkedIn Case Study):**
-> **Before:** A year ago, our Telegram channel had 200 subscribers and 30 views per post.
-> **After:** Today, we have 15,000 subscribers, 8,000 views, and the channel brings in 40% of our leads.
-> **Bridge:** What changed: a content calendar using the 40/30/20/10 formula + daily posts at 9:00 AM. Here are 3 principles that worked →
-
----
-
-### 4. Hero's Journey (Simplified)
-
-**Essence:** The hero's tale: ordinary world → call to action (challenge) → transformation → new world.
-**Best for:** Brand stories, case studies, inspiring content, videos.
-
-| Stage | What it does | Emotional Arc |
-|-------|--------------|---------------|
-| **Ordinary World** | The "before" — hero (client/brand) in their usual environment | Identification |
-| **Challenge** | The problem, crisis, or task that forces action | Tension |
-| **Transformation** | What changed — solution found, barriers overcome | Climax |
-| **New World** | The result — the hero has changed, life is better | Catharsis, Inspiration |
-
-**Example (Brand Story Video):**
-> **Ordinary World:** Maria is a startup marketer. She does everything and is burning out.
-> **Challenge:** The CEO targets a 3x lead increase for the quarter. With no budget and no team.
-> **Transformation:** Maria implements an AI content strategy, automates routine tasks, and focuses on creativity.
-> **New World:** Leads increased 4x, Maria gets promoted, and she hires a team.
-
----
-
-### 5. STAR — Situation → Task → Action → Result
-
-**Essence:** A structured case study featuring data.
-**Best for:** Case studies, portfolios, LinkedIn, B2B.
-
-| Stage | What it does | Emotional Arc |
-|-------|--------------|---------------|
-| **S — Situation** | Context: who, where, when | Understanding the context |
-| **T — Task** | Goal: what needed to be achieved | Focus: "a difficult task" |
-| **A — Action** | Specific steps: what was done | Interest: "how exactly?" |
-| **R — Result** | Outcome with numbers | Trust: "here is the proof" |
-
-**Example (LinkedIn, B2B):**
-> **S:** Our client is a SaaS startup with 50 trials/month and a 3% paid conversion rate.
-> **T:** Increase the trial-to-paid conversion to 10% within 3 months.
-> **A:** Restructured the onboarding email sequence (5 emails), added in-app tooltips, launched a win-back campaign for churned users.
-> **R:** Reached a 12.4% conversion rate in 2.5 months. LTV increased by 35%.
-
----
-
-### 6. PASTOR — Problem → Amplify → Story → Transformation → Offer → Response
-
-**Essence:** An expanded PAS framework featuring a story and an offer. The most comprehensive sales framework.
-**Best for:** Long landing pages, sales pages, email sequences.
-
-| Stage | What it does |
-|-------|--------------|
-| **P — Problem** | Describe the problem |
-| **A — Amplify** | Amplify the consequences (stronger than Agitate in PAS) |
-| **S — Story** | Tell a story (yours or a client's) |
-| **T — Transformation** | Showcase the transformation (before → after) |
-| **O — Offer** | Present the offer |
-| **R — Response** | Call to a specific action |
-
----
-
-### 7. Pixar Formula
-
-**Essence:** The Pixar formula for simple yet powerful stories.
-**Best for:** Short stories, reels, posts, inspirational content.
-
-```
-Once upon a time, [hero].
-Every day, they [routine].
-One day, [plot twist event].
-Because of that, [consequence 1].
-Because of that, [consequence 2].
-Until finally, [resolution / new reality].
-```
-
-**Example (Instagram Reel):**
-> Once upon a time, there was a marketer who spent 6 hours on a content plan. Every day, he manually collected topics, wrote texts, and sourced images. One day, he tried AI tools. Because of that, planning dropped to 30 minutes. Because of that, he finally had time for strategy. Until finally, the content started bringing in leads, not just likes.
-
----
-
-### 8. FAB — Features → Advantages → Benefits
-
-**Essence:** Shift from product characteristics to user benefits.
-**Best for:** Product posts, descriptions, product cards.
-
-| Stage | What it does | Example (Email Service) |
-|-------|--------------|-------------------------|
-| **F — Features** | What it has (characteristic) | "Drag-and-drop editor" |
-| **A — Advantages** | Why it's better (advantage) | "No designer or coding required" |
-| **B — Benefits** | What it brings to the user (benefit) | "Create beautiful emails yourself in 10 minutes" |
-
----
-
-### 9. 4P — Promise → Picture → Proof → Push
-
-**Essence:** Promise → visualization → proof → push to action.
-**Best for:** Educational content, how-tos, carousels.
-
-| Stage | What it does |
-|-------|--------------|
-| **Promise** | Guarantee a specific result |
-| **Picture** | Paint a picture: what life will look like after |
-| **Proof** | Back it up: data, case studies, social proof |
-| **Push** | CTA: urge to take action |
-
----
-
-### 10. Open Loop
-
-**Essence:** Start a story but don't finish it → create intrigue → finish it at the end (or in the next piece of content).
-**Best for:** Series, threads, reels (retention), emails (open rate).
-
-```
-[Hook: unanswered question / beginning of an unfinished story]
-↓
-[Content: value, key points, development]
-↓
-[Closing the loop: answering the question / story ending]
-```
-
-> The Open Loop holds attention until the end. Leaving the loop open at the end motivates users to subscribe or read part 2.
-
-## Emotional Arc — How to Build Tension
-
-Every good narrative follows an emotional arc:
-
-```
-Emotion
-  │
-  │         ╱ Climax
-  │        ╱
-  │       ╱
-  │      ╱
-  │     ╱
-  │    ╱ Rising tension
-  │   ╱
-  ├──╱─────────── Hook 
-  │ ╱
-  │╱   Setup (context)
-  └──────────────────────────── Time
-          Conflict    Resolution → CTA
-```
-
-### Elements of the Emotional Arc
-
-| Element | What it does | Where in the text |
-|---------|--------------|-------------------|
-| **Hook** | Grabs attention — surprising fact, question, contradiction | First sentence / first 3 seconds of a video |
-| **Setup** | Context — who is the hero, where are they, what is happening | 2-3 sentences after the hook |
-| **Conflict** | Tension — problem, barrier, challenge | Middle section |
-| **Rising Action**| Amplification — consequences, stakes are raised | Before the climax |
-| **Climax** | Peak moment — turning point, insight, solution | 2/3 into the text |
-| **Resolution** | Result — what changed, the lesson, takeaway | Penultimate paragraph |
-| **CTA** | Action — naturally flows from the resolution | Last sentence |
-
-> **Rule:** No conflict = no story. Even educational content has conflict: "ignorance → knowledge", "mistake → correction".
-
-## Platform Adaptation
-
-| Platform | Narrative Length | Depth | Best Frameworks |
-|----------|------------------|-------|-----------------|
-| **Instagram (post)** | Short (500-1500 characters) | 1-2 framework stages | PAS, BAB, Open Loop |
-| **Instagram (carousel)** | Medium (1 slide = 1 stage) | Full framework | AIDA, 4P, STAR |
-| **Instagram (reel)** | 15-60 seconds | Express narrative | Pixar, BAB, Open Loop |
-| **LinkedIn** | Med-Long (1000-2500 chars) | Full framework | STAR, BAB, Hero's Journey |
-| **Telegram** | Medium (1000-3000 chars) | Full framework | PAS, STAR, BAB |
-| **Email** | Medium (150-500 words) | Depends on email type | PAS (promo), AIDA (launch), PASTOR (long-form sales) |
-| **Blog / Article** | Long (1500-4000 words) | Expanded framework | Hero's Journey, PASTOR, STAR |
-| **YouTube** | 3-15 minutes | Full with visual storytelling | Hero's Journey, Open Loop, Pixar |
-| **TikTok** | 15-60 seconds | Express | Pixar, Open Loop, BAB |
-
-## Protocol
-
-### Step 1 — Context
-1. Define the goal, persona, platform, and content type.
-2. Using the Decision Tree, select **1 framework**.
-3. Determine narrative length and depth based on the platform.
-
-### Step 2 — Data for Narrative
-1. Collect facts, data, quotes (from `$topic-research`, `$data-storytelling`).
-2. Identify the **hero** of the story: client? user? brand? abstract persona?
-3. Define the **conflict**: what is the problem / challenge / barrier?
-
-### Step 3 — Filling the Framework
-1. Fill each stage of the framework with specific data.
-2. Check the **emotional arc**: is there tension → climax → resolution?
-3. Ensure the CTA flows **naturally** from the resolution (not tacked on).
-
-### Step 4 — Narrative Review
-Run through the checklist:
-1. Is there a **conflict**? (no conflict = no story)
-2. Is there a **transformation**? (the hero changed)
-3. Does the reader **recognize themselves** in the hero? (identification)
-4. Does the story lead to the **CTA** naturally? 
-5. Does the **Hook** in the first sentence grab attention? (avoid starting with context)
-
-### Step 5 — Platform Adaptation
-1. Adjust the length for the platform.
-2. For carousels — 1 stage = 1 slide.
-3. For videos — visualize each stage.
-
-## Validation (Quality Gate)
-
-The narrative is considered ready if:
-
-- [ ] Framework chosen via Decision Tree (goal × platform)
-- [ ] All framework stages are filled with specific data
-- [ ] Conflict/tension exists (text isn't flat)
-- [ ] Transformation exists (hero changed / reader learned something new)
-- [ ] Hook is strictly in the first sentence (does not start with context)
-- [ ] CTA flows naturally from the resolution
-- [ ] Emotional arc is observable
-- [ ] Length is adapted for the platform
-- [ ] Reader can recognize themselves in the hero (identification with Audience Persona)
-
-## Handoff
-
-| Consumer | How it is used |
-|----------|----------------|
-| `$content-brief` | Framework acts as part of the "Structure" section |
-| Copywriter (agent) | Writes the text based on the mapped-out framework |
-| `$email-copywriting` | PAS / AIDA / PASTOR adapted for email blocks |
-| `$social-media-formats`| Narrative gets adapted into the platform's format rules |
-| `$headline-formulas` | Hook from the narrative → becomes the headline |
-| `$cta-optimization` | CTA mapped directly from narrative resolution |
-
-## Integration with other skills
-
-| Skill | Interaction |
-|-------|-------------|
-| `$audience-analysis` | **Source:** persona, pain points, triggers → hero and conflict |
-| `$data-storytelling` | **Complement:** data story = data + narrative from this skill |
-| `$content-brief` | **Consumer:** the framework is used in the brief's "Structure" |
-| `$topic-research` | **Source:** facts and data to fill the framework stages |
-| `$headline-formulas` | **Consumer:** hook transforms into the headline |
-| `$cta-optimization` | **Consumer:** CTA is taken from the resolution |
-| `$tone-of-voice` | **Source:** dictates the tone of the narrative |
-
-## Anti-patterns
-
-| Mistake | Why it's bad | How to do it right |
-|---------|--------------|--------------------|
-| No conflict | Text is flat and unengaging | Even how-to guides have a conflict: going from ignorance → knowledge |
-| Starting with context, not a hook | Reader drops off before the actual point is made | Hook in the first sentence, context in the second |
-| Pinned-on CTA | "And by the way, buy our product" post a cat story | CTA must flow naturally from the narrative's resolution |
-| Mixing frameworks | PAS + AIDA + Hero's Journey = chaos | Utilize just one framework per piece of content |
-| Brand as the hero | The brand praises itself; lacks consumer identification | The consumer/client is the hero. The brand is the guide/helper |
-| Missing transformation | "Things were bad. Here is the solution." — feels hollow | Reveal the entire journey from Before to After |
-| Elongated story in short format | Hero's Journey in a single tweet is compressed and confusing | The platform regulates the optimal framework and depth |
-| Made-up story without label | If the audience senses fraud, trust is broken | Real cases > fiction. Otherwise, preface with: "Imagine a situation..." |
-
-## Output Template
-
-```markdown
-### Storytelling Framework — [Topic / Content]
-
-**Goal:** [persuade / inspire / educate / entertain / sell]
-**Persona:** [from $audience-analysis]
-**Platform:** [target platform]
-**Content Type:** [post / carousel / email / article / reel / video]
-
----
-
-#### Selected Framework: [Name]
-**Why:** [Decision Tree rationale]
-
----
-
-#### Filled Framework
-
-**[Stage 1 — name]:**
-[Content — specific data, facts, phrasing]
-
-**[Stage 2 — name]:**
-[Content]
-
-**[Stage 3 — name]:**
-[Content]
-
-**[Stage N — name / CTA]:**
-[Content]
-
----
-
-#### Emotional Arc
-
-| Element | Where in text | Emotion |
-|---------|---------------|---------|
-| Hook | [1st sentence / first 3 sec] | [curiosity / shock / recognition] |
-| Conflict | [where in text] | [tension / anxiety] |
-| Climax | [where in text] | [insight / turning point] |
-| Resolution | [where in text] | [relief / inspiration] |
-| CTA | [last sentence] | [determination / action] |
-
----
-
-#### Narrative Checklist
-
-| Criterion | Status |
-|-----------|--------|
-| Conflict exists | ✅/❌ |
-| Transformation exists | ✅/❌ |
-| Hook is the first sentence | ✅/❌ |
-| Reader recognizes themselves | ✅/❌ |
-| CTA is natural | ✅/❌ |
-| Length adapted to platform | ✅/❌ |
-
-**→ Next Step:** Pass to `$content-brief` ("Structure" section) / Copywriter / `$social-media-formats`
-```
+---
+name: storytelling-framework
+description: Storytelling frameworks — 10 frameworks, Decision Tree, emotional arc, platform adaptation, examples
+---
+# Storytelling Framework
+
+## When to Use
+- When creating **narrative content** — articles, long posts, emails, video scripts, case studies.
+- For **promotional content** — landing pages, promos, offers.
+- For **engaging content** — personal stories, behind the scenes, transformations.
+- As part of the **`$content-brief`** — to select a narrative structure for a specific piece of content.
+
+## Input
+
+| Field | Required | Description |
+|-------|:--------:|-------------|
+| Content Goal | ✅ | Persuade / inspire / educate / entertain / sell |
+| Audience Persona | ✅ | From `$audience-analysis` — pain points, triggers, language |
+| Platform | ✅ | Determines the length and depth of the narrative |
+| Content Type | ✅ | Post / article / email / reel / landing page / case study / video |
+| Key Data / Facts | ⬚ | From `$topic-research` / `$data-storytelling` — if data-driven |
+| Product / Offer | ⬚ | If promotional content — what is being promoted |
+
+> If the goal is not specified — **request it**. A framework without a goal equals a random choice.
+
+## Decision Tree — Framework Selection
+
+| Goal | Content Type | Recommended Frameworks |
+|------|--------------|------------------------|
+| **Sell** (conversion) | Landing, promo, email | PAS, PASTOR, AIDA, FAB |
+| **Persuade** (opinion) | Post, article, LinkedIn | BAB, PAS, StoryBrand |
+| **Educate** (know-how) | Carousel, article, video | 4P, STAR, How-to (AIDA adaptation) |
+| **Inspire** (motivation) | Post, reel, email | Hero's Journey, BAB, Pixar Formula |
+| **Case Study** (result) | Post, article, video | STAR, BAB, Hero's Journey |
+| **Entertain** (engagement) | Reel, post, TikTok | Pixar Formula, Open Loop |
+
+> Select **1 framework** for each piece of content. Do not mix them.
+
+## Frameworks
+
+### 1. PAS — Problem → Agitate → Solution
+
+**Essence:** Highlight the problem, agitate the pain point, provide the solution.
+**Best for:** Promotional, MOFU/BOFU, email, landing pages.
+
+| Stage | What it does | Emotional Arc |
+|-------|--------------|---------------|
+| **P — Problem** | Describe a problem relatable to the audience | Recognition: "this is about me" |
+| **A — Agitate** | Intensify the pain: what happens if not resolved? Consequences | Tension: anxiety, frustration |
+| **S — Solution** | Present the solution (product/method) + CTA | Relief: "this is how to fix it" |
+
+**Example (Instagram, email marketing):**
+> **P:** Spending 3 hours on one email blast?
+> **A:** While you manually compile emails, competitors have automated the whole process. Every day of delay means lost leads.
+> **S:** [Product] lets you build an email campaign in 15 minutes. Try it for free →
+
+---
+
+### 2. AIDA — Attention → Interest → Desire → Action
+
+**Essence:** The classic advertising funnel within a single text.
+**Best for:** Ads, promos, landing pages.
+
+| Stage | What it does | Emotional Arc |
+|-------|--------------|---------------|
+| **A — Attention** | Hook — grab attention | Curiosity |
+| **I — Interest** | Why this is important for the reader | Interest: "tell me more" |
+| **D — Desire** | Benefits, transformation, social proof | Desire: "I want this too" |
+| **A — Action** | Specific CTA | Resolution: "I'm doing this now" |
+
+**Example (SaaS landing page):**
+> **A:** 87% of marketers spend over 5 hours a week scheduling content manually.
+> **I:** What if AI could do it for you — and do it better?
+> **D:** [Product] creates content plans, writes texts, and publishes on schedule. Over 500 companies have already switched.
+> **A:** Start your 14-day free trial →
+
+---
+
+### 3. BAB — Before → After → Bridge
+
+**Essence:** Show the "before/after" contrast and the bridge on how to get there.
+**Best for:** Case studies, motivational posts, transformation, LinkedIn.
+
+| Stage | What it does | Emotional Arc |
+|-------|--------------|---------------|
+| **Before** | The "before" situation — pain, problem | Recognition |
+| **After** | The "after" situation — result, dream | Inspiration: "I want to be there" |
+| **Bridge** | How to cross from Before to After (product/method/action) | Decision: "here is my path" |
+
+**Example (LinkedIn Case Study):**
+> **Before:** A year ago, our Telegram channel had 200 subscribers and 30 views per post.
+> **After:** Today, we have 15,000 subscribers, 8,000 views, and the channel brings in 40% of our leads.
+> **Bridge:** What changed: a content calendar using the 40/30/20/10 formula + daily posts at 9:00 AM. Here are 3 principles that worked →
+
+---
+
+### 4. Hero's Journey (Simplified)
+
+**Essence:** The hero's tale: ordinary world → call to action (challenge) → transformation → new world.
+**Best for:** Brand stories, case studies, inspiring content, videos.
+
+| Stage | What it does | Emotional Arc |
+|-------|--------------|---------------|
+| **Ordinary World** | The "before" — hero (client/brand) in their usual environment | Identification |
+| **Challenge** | The problem, crisis, or task that forces action | Tension |
+| **Transformation** | What changed — solution found, barriers overcome | Climax |
+| **New World** | The result — the hero has changed, life is better | Catharsis, Inspiration |
+
+**Example (Brand Story Video):**
+> **Ordinary World:** Maria is a startup marketer. She does everything and is burning out.
+> **Challenge:** The CEO targets a 3x lead increase for the quarter. With no budget and no team.
+> **Transformation:** Maria implements an AI content strategy, automates routine tasks, and focuses on creativity.
+> **New World:** Leads increased 4x, Maria gets promoted, and she hires a team.
+
+---
+
+### 5. STAR — Situation → Task → Action → Result
+
+**Essence:** A structured case study featuring data.
+**Best for:** Case studies, portfolios, LinkedIn, B2B.
+
+| Stage | What it does | Emotional Arc |
+|-------|--------------|---------------|
+| **S — Situation** | Context: who, where, when | Understanding the context |
+| **T — Task** | Goal: what needed to be achieved | Focus: "a difficult task" |
+| **A — Action** | Specific steps: what was done | Interest: "how exactly?" |
+| **R — Result** | Outcome with numbers | Trust: "here is the proof" |
+
+**Example (LinkedIn, B2B):**
+> **S:** Our client is a SaaS startup with 50 trials/month and a 3% paid conversion rate.
+> **T:** Increase the trial-to-paid conversion to 10% within 3 months.
+> **A:** Restructured the onboarding email sequence (5 emails), added in-app tooltips, launched a win-back campaign for churned users.
+> **R:** Reached a 12.4% conversion rate in 2.5 months. LTV increased by 35%.
+
+---
+
+### 6. PASTOR — Problem → Amplify → Story → Transformation → Offer → Response
+
+**Essence:** An expanded PAS framework featuring a story and an offer. The most comprehensive sales framework.
+**Best for:** Long landing pages, sales pages, email sequences.
+
+| Stage | What it does |
+|-------|--------------|
+| **P — Problem** | Describe the problem |
+| **A — Amplify** | Amplify the consequences (stronger than Agitate in PAS) |
+| **S — Story** | Tell a story (yours or a client's) |
+| **T — Transformation** | Showcase the transformation (before → after) |
+| **O — Offer** | Present the offer |
+| **R — Response** | Call to a specific action |
+
+---
+
+### 7. Pixar Formula
+
+**Essence:** The Pixar formula for simple yet powerful stories.
+**Best for:** Short stories, reels, posts, inspirational content.
+
+```
+Once upon a time, [hero].
+Every day, they [routine].
+One day, [plot twist event].
+Because of that, [consequence 1].
+Because of that, [consequence 2].
+Until finally, [resolution / new reality].
+```
+
+**Example (Instagram Reel):**
+> Once upon a time, there was a marketer who spent 6 hours on a content plan. Every day, he manually collected topics, wrote texts, and sourced images. One day, he tried AI tools. Because of that, planning dropped to 30 minutes. Because of that, he finally had time for strategy. Until finally, the content started bringing in leads, not just likes.
+
+---
+
+### 8. FAB — Features → Advantages → Benefits
+
+**Essence:** Shift from product characteristics to user benefits.
+**Best for:** Product posts, descriptions, product cards.
+
+| Stage | What it does | Example (Email Service) |
+|-------|--------------|-------------------------|
+| **F — Features** | What it has (characteristic) | "Drag-and-drop editor" |
+| **A — Advantages** | Why it's better (advantage) | "No designer or coding required" |
+| **B — Benefits** | What it brings to the user (benefit) | "Create beautiful emails yourself in 10 minutes" |
+
+---
+
+### 9. 4P — Promise → Picture → Proof → Push
+
+**Essence:** Promise → visualization → proof → push to action.
+**Best for:** Educational content, how-tos, carousels.
+
+| Stage | What it does |
+|-------|--------------|
+| **Promise** | Guarantee a specific result |
+| **Picture** | Paint a picture: what life will look like after |
+| **Proof** | Back it up: data, case studies, social proof |
+| **Push** | CTA: urge to take action |
+
+---
+
+### 10. Open Loop
+
+**Essence:** Start a story but don't finish it → create intrigue → finish it at the end (or in the next piece of content).
+**Best for:** Series, threads, reels (retention), emails (open rate).
+
+```
+[Hook: unanswered question / beginning of an unfinished story]
+↓
+[Content: value, key points, development]
+↓
+[Closing the loop: answering the question / story ending]
+```
+
+> The Open Loop holds attention until the end. Leaving the loop open at the end motivates users to subscribe or read part 2.
+
+## Emotional Arc — How to Build Tension
+
+Every good narrative follows an emotional arc:
+
+```
+Emotion
+  │
+  │         ╱ Climax
+  │        ╱
+  │       ╱
+  │      ╱
+  │     ╱
+  │    ╱ Rising tension
+  │   ╱
+  ├──╱─────────── Hook 
+  │ ╱
+  │╱   Setup (context)
+  └──────────────────────────── Time
+          Conflict    Resolution → CTA
+```
+
+### Elements of the Emotional Arc
+
+| Element | What it does | Where in the text |
+|---------|--------------|-------------------|
+| **Hook** | Grabs attention — surprising fact, question, contradiction | First sentence / first 3 seconds of a video |
+| **Setup** | Context — who is the hero, where are they, what is happening | 2-3 sentences after the hook |
+| **Conflict** | Tension — problem, barrier, challenge | Middle section |
+| **Rising Action**| Amplification — consequences, stakes are raised | Before the climax |
+| **Climax** | Peak moment — turning point, insight, solution | 2/3 into the text |
+| **Resolution** | Result — what changed, the lesson, takeaway | Penultimate paragraph |
+| **CTA** | Action — naturally flows from the resolution | Last sentence |
+
+> **Rule:** No conflict = no story. Even educational content has conflict: "ignorance → knowledge", "mistake → correction".
+
+## Platform Adaptation
+
+| Platform | Narrative Length | Depth | Best Frameworks |
+|----------|------------------|-------|-----------------|
+| **Instagram (post)** | Short (500-1500 characters) | 1-2 framework stages | PAS, BAB, Open Loop |
+| **Instagram (carousel)** | Medium (1 slide = 1 stage) | Full framework | AIDA, 4P, STAR |
+| **Instagram (reel)** | 15-60 seconds | Express narrative | Pixar, BAB, Open Loop |
+| **LinkedIn** | Med-Long (1000-2500 chars) | Full framework | STAR, BAB, Hero's Journey |
+| **Telegram** | Medium (1000-3000 chars) | Full framework | PAS, STAR, BAB |
+| **Email** | Medium (150-500 words) | Depends on email type | PAS (promo), AIDA (launch), PASTOR (long-form sales) |
+| **Blog / Article** | Long (1500-4000 words) | Expanded framework | Hero's Journey, PASTOR, STAR |
+| **YouTube** | 3-15 minutes | Full with visual storytelling | Hero's Journey, Open Loop, Pixar |
+| **TikTok** | 15-60 seconds | Express | Pixar, Open Loop, BAB |
+
+## Protocol
+
+### Step 1 — Context
+1. Define the goal, persona, platform, and content type.
+2. Using the Decision Tree, select **1 framework**.
+3. Determine narrative length and depth based on the platform.
+
+### Step 2 — Data for Narrative
+1. Collect facts, data, quotes (from `$topic-research`, `$data-storytelling`).
+2. Identify the **hero** of the story: client? user? brand? abstract persona?
+3. Define the **conflict**: what is the problem / challenge / barrier?
+
+### Step 3 — Filling the Framework
+1. Fill each stage of the framework with specific data.
+2. Check the **emotional arc**: is there tension → climax → resolution?
+3. Ensure the CTA flows **naturally** from the resolution (not tacked on).
+
+### Step 4 — Narrative Review
+Run through the checklist:
+1. Is there a **conflict**? (no conflict = no story)
+2. Is there a **transformation**? (the hero changed)
+3. Does the reader **recognize themselves** in the hero? (identification)
+4. Does the story lead to the **CTA** naturally? 
+5. Does the **Hook** in the first sentence grab attention? (avoid starting with context)
+
+### Step 5 — Platform Adaptation
+1. Adjust the length for the platform.
+2. For carousels — 1 stage = 1 slide.
+3. For videos — visualize each stage.
+
+## Validation (Quality Gate)
+
+The narrative is considered ready if:
+
+- [ ] Framework chosen via Decision Tree (goal × platform)
+- [ ] All framework stages are filled with specific data
+- [ ] Conflict/tension exists (text isn't flat)
+- [ ] Transformation exists (hero changed / reader learned something new)
+- [ ] Hook is strictly in the first sentence (does not start with context)
+- [ ] CTA flows naturally from the resolution
+- [ ] Emotional arc is observable
+- [ ] Length is adapted for the platform
+- [ ] Reader can recognize themselves in the hero (identification with Audience Persona)
+
+## Handoff
+
+| Consumer | How it is used |
+|----------|----------------|
+| `$content-brief` | Framework acts as part of the "Structure" section |
+| Copywriter (agent) | Writes the text based on the mapped-out framework |
+| `$email-copywriting` | PAS / AIDA / PASTOR adapted for email blocks |
+| `$social-media-formats`| Narrative gets adapted into the platform's format rules |
+| `$headline-formulas` | Hook from the narrative → becomes the headline |
+| `$cta-optimization` | CTA mapped directly from narrative resolution |
+
+## Integration with other skills
+
+| Skill | Interaction |
+|-------|-------------|
+| `$audience-analysis` | **Source:** persona, pain points, triggers → hero and conflict |
+| `$data-storytelling` | **Complement:** data story = data + narrative from this skill |
+| `$content-brief` | **Consumer:** the framework is used in the brief's "Structure" |
+| `$topic-research` | **Source:** facts and data to fill the framework stages |
+| `$headline-formulas` | **Consumer:** hook transforms into the headline |
+| `$cta-optimization` | **Consumer:** CTA is taken from the resolution |
+| `$tone-of-voice` | **Source:** dictates the tone of the narrative |
+
+## Anti-patterns
+
+| Mistake | Why it's bad | How to do it right |
+|---------|--------------|--------------------|
+| No conflict | Text is flat and unengaging | Even how-to guides have a conflict: going from ignorance → knowledge |
+| Starting with context, not a hook | Reader drops off before the actual point is made | Hook in the first sentence, context in the second |
+| Pinned-on CTA | "And by the way, buy our product" post a cat story | CTA must flow naturally from the narrative's resolution |
+| Mixing frameworks | PAS + AIDA + Hero's Journey = chaos | Utilize just one framework per piece of content |
+| Brand as the hero | The brand praises itself; lacks consumer identification | The consumer/client is the hero. The brand is the guide/helper |
+| Missing transformation | "Things were bad. Here is the solution." — feels hollow | Reveal the entire journey from Before to After |
+| Elongated story in short format | Hero's Journey in a single tweet is compressed and confusing | The platform regulates the optimal framework and depth |
+| Made-up story without label | If the audience senses fraud, trust is broken | Real cases > fiction. Otherwise, preface with: "Imagine a situation..." |
+
+## Output Template
+
+```markdown
+### Storytelling Framework — [Topic / Content]
+
+**Goal:** [persuade / inspire / educate / entertain / sell]
+**Persona:** [from $audience-analysis]
+**Platform:** [target platform]
+**Content Type:** [post / carousel / email / article / reel / video]
+
+---
+
+#### Selected Framework: [Name]
+**Why:** [Decision Tree rationale]
+
+---
+
+#### Filled Framework
+
+**[Stage 1 — name]:**
+[Content — specific data, facts, phrasing]
+
+**[Stage 2 — name]:**
+[Content]
+
+**[Stage 3 — name]:**
+[Content]
+
+**[Stage N — name / CTA]:**
+[Content]
+
+---
+
+#### Emotional Arc
+
+| Element | Where in text | Emotion |
+|---------|---------------|---------|
+| Hook | [1st sentence / first 3 sec] | [curiosity / shock / recognition] |
+| Conflict | [where in text] | [tension / anxiety] |
+| Climax | [where in text] | [insight / turning point] |
+| Resolution | [where in text] | [relief / inspiration] |
+| CTA | [last sentence] | [determination / action] |
+
+---
+
+#### Narrative Checklist
+
+| Criterion | Status |
+|-----------|--------|
+| Conflict exists | ✅/❌ |
+| Transformation exists | ✅/❌ |
+| Hook is the first sentence | ✅/❌ |
+| Reader recognizes themselves | ✅/❌ |
+| CTA is natural | ✅/❌ |
+| Length adapted to platform | ✅/❌ |
+
+**→ Next Step:** Pass to `$content-brief` ("Structure" section) / Copywriter / `$social-media-formats`
+```