code-ai-installer 1.5.5 → 2.0.1

package/domains/content/locales/en/.agents/skills/source-verification/SKILL.md

@@ -0,0 +1,269 @@
+---
+name: source-verification
+description: Source verification — CRAAP framework, source types, bias checking, strictness levels, credibility rating
+---
+# Source Verification
+
+## When to Use
+- After **`$topic-research`** — before handing data over to the Copywriter.
+- In parallel with **`$fact-checking`** — at the Reviewer stage.
+- Whenever there is **doubt about a source** — check any source before using it.
+- For **data-driven content** — all data sources must be verified.
+
+> **Distinction from `$fact-checking`:** Source verification checks the **source** (who, when, how reliable). Fact checking checks the **claim** (is what is written true). Source verification → input for fact checking.
+
+## Input
+
+| Field | Required | Description |
+|-------|:--------:|-------------|
+| List of sources | ✅ | URLs, names, links — what is being checked |
+| Content Type | ✅ | Determines the strictness level |
+| Topic | ✅ | Context: in what domain the source is used |
+| Where sources are from | ⬚ | From `$topic-research` / user / SERP / competitors |
+
+## Strictness Levels
+
+| Level | Content Types | Minimum Rating | Features |
+|-------|---------------|----------------|----------|
+| 🔴 **Maximum** | Medical, finance, legal, scientific topics (YMYL) | ⭐⭐⭐⭐ and above | Only peer-reviewed, gov statistics. Conflict of interest = rejection |
+| 🟡 **Standard** | Articles, case studies, analytics, email, longreads | ⭐⭐⭐ and above | Authoritative media, industry reports are acceptable |
+| 🔵 **Basic** | Social media, short posts, entertaining | ⭐⭐ and above (with cross-checking) | Blogs are acceptable if the fact is confirmed by a second source |
+
+## CRAAP Framework
+
+Every source is checked against 5 criteria:
+
+| Criterion | Questions to check | Red flags |
+|-----------|--------------------|-----------|
+| **C — Currency** | When was it published? Updated? Is the data current for our topic? | Older than 2 years for tech/business. Older than 5 years for science. Links to even older sources |
+| **R — Relevance** | Is the source on our topic? Needed depth? Target audience matches? | Adjacent topic passed off as direct. Scientific paper for a pop post (overkill) or blog for a scientific topic (insufficient) |
+| **A — Authority** | Who is the author? Qualifications? Publication reputation? Peer-reviewed? | Unknown author. Publication without an editorial board. Self-published without verification |
+| **A — Accuracy** | Is data confirmed by other sources? Methodology described? Links to primary sources? | No methodology. No primary sources. Data contradicts other reliable sources |
+| **P — Purpose** | Why was it written? To inform? Sell? Persuade? Hidden agenda? | Promotional content disguised as research. Sponsored research without disclosure |
+
+### CRAAP Scoring
+
+Each criterion: **1 (poor) — 3 (average) — 5 (excellent)**
+
+| Total (out of 25) | Interpretation |
+|-------------------|----------------|
+| 21-25 | Excellent source — use without restrictions |
+| 16-20 | Good — use, but cross-check key data |
+| 11-15 | Questionable — use only with cross-confirmation from ≥ 2 other sources |
+| ≤ 10 | Unreliable — do not use |
+
+## Source Types — Specific Criteria
+
+### Scientific Study / Peer-reviewed Journal
+| What to check | How |
+|---------------|-----|
+| Peer review | Peer-reviewed journal (not a preprint without review) |
+| Sample size | Is N sufficient for conclusions? |
+| Methodology | Described, reproducible? |
+| Funding | Who sponsored? Is there a disclosure? |
+| Retraction | Has the paper been retracted? (check Retraction Watch) |
+
+### News Article / Media
+| What to check | How |
+|---------------|-----|
+| Publication | Major / independent / tabloid? |
+| Author | Journalist with a track record or "editorial team"? |
+| Sources | Quotes from experts? Links to the original? |
+| Date | Current? Not updated with new data? |
+| Bias | Political / commercial bias of the publication? |
+
+### Corporate Report / Press Release
+| What to check | How |
+|---------------|-----|
+| Conflict of interest | Is the company promoting its product via "research"? |
+| Methodology | Is it described? Or just conclusions? |
+| Sample | Only company clients = biased sample |
+| Cross-checking | Do independent sources confirm this? |
+
+### Blog / Expert Post
+| What to check | How |
+|---------------|-----|
+| Author | Real expert with verifiable qualifications? |
+| Sources | Cites primary data or "in my experience"? |
+| Bias | Affiliate? Promoting a product? |
+| Cross-checking | Mandatory — a blog is not a self-sufficient source |
+
+### Social Media / Reddit / Quora
+| What to check | How |
+|---------------|-----|
+| Author | Verified account? Real expert? |
+| Evidence | Are there links, screenshots, data? |
+| Consensus | Opinion of one person or confirmed by others? |
+| **Rule** | Do not use as a sole source. Only as an illustration + cross-confirmation |
+
+## Bias Checking
+
+| Bias Type | How to detect | Example |
+|-----------|---------------|---------|
+| **Commercial** | Source sells a product related to the conclusions | "Our study showed our product is the best" |
+| **Sponsored** | Study paid for by an interested party | Pharma company sponsors study of its own drug |
+| **Selection bias** | Sample is not representative | Survey only among clients = biased results |
+| **Confirmation bias** | Data cherry-picked to fit the conclusion | Showing only confirming facts |
+| **Survivorship bias** | Only successful cases considered | "All successful startups do X" (failed ones did too) |
+| **Ideological** | Publication has a political stance | Politically biased media on business regulation |
+
+> If bias is detected — **do not automatically reject**, but lower the rating + note the bias + require cross-confirmation.
+
+## Rating Scale (Extended)
+
+| Rating | Source Type | Examples | Acceptability |
+|--------|-------------|----------|---------------|
+| ⭐⭐⭐⭐⭐ | Primary / academic | Peer-reviewed journals (Nature, Lancet, JAMA), gov statistics (BLS, Eurostat), SEC filings, patents | All strictness levels |
+| ⭐⭐⭐⭐ | Authoritative secondary | Major editorial media (Reuters, Bloomberg, BBC), reports from analytical companies (McKinsey, Gartner, Statista), official major company blogs | All strictness levels |
+| ⭐⭐⭐ | Reliable secondary | Industry media (TechCrunch, The Verge), expert books, corporate reports with methodology, major editorial blogs | 🟡 Standard and below |
+| ⭐⭐ | User-generated content | Personal expert blogs, podcasts, professional YouTube channels, Reddit (verified), Quora (with credentials) | 🔵 Basic (with cross-checking) |
+| ⭐ | Unreliable | Anonymous sources, content farms, affiliate sites, tabloids, unverifiable data | ❌ Do not use |
+
+### Edge Cases
+
+| Situation | Decision |
+|-----------|----------|
+| Corporate report (McKinsey) vs corporate blog (NoName SaaS) | McKinsey = ⭐⭐⭐⭐ (methodology, reputation). NoName SaaS = ⭐⭐⭐ (possible bias) |
+| Wikipedia | ⭐⭐ — NOT a standalone source. Use Wikipedia links → find and verify primary sources |
+| Preprint (not peer-reviewed) | ⭐⭐⭐ — lower by 1 star from the journal. Note "preprint, not peer-reviewed" |
+| Survey with small sample (N < 100) | Lower by 1 star. Note "small sample: N = [number]" |
+
+## Protocol
+
+### Step 1 — Preparation
+1. Receive list of sources and content type.
+2. Determine strictness level (🔴 / 🟡 / 🔵).
+3. Determine the minimum acceptable rating.
+
+### Step 2 — CRAAP Assessment
+For each source:
+1. Go through **5 CRAAP criteria** (Currency, Relevance, Authority, Accuracy, Purpose).
+2. Score each 1-5 points.
+3. Calculate total (out of 25).
+
+### Step 3 — Source Type
+1. Classify: scientific / media / corporate / blog / social.
+2. Apply **specific criteria** for the type.
+3. For scientific: check retraction, methodology, funding.
+4. For corporate: check conflict of interest.
+
+### Step 4 — Bias Check
+1. Check for 6 types of bias.
+2. If bias is found — lower rating + flag it + require cross-confirmation.
+
+### Step 5 — Rating and Decision
+1. Assign **rating** (⭐ — ⭐⭐⭐⭐⭐).
+2. Compare with the minimum acceptable for the strictness level.
+3. Decision: ✅ Accepted / ⚠️ Conditional (requires cross-check) / ❌ Rejected.
+
+### Step 6 — Primary Sources
+1. For each secondary source — **find the primary source**.
+2. If the primary source is unavailable — flag it and lower the rating.
+
+## Validation (Quality Gate)
+
+Verification is considered complete if:
+
+- [ ] All sources from the list are checked (none skipped)
+- [ ] CRAAP score conducted for every source
+- [ ] Type of every source is determined, specific criteria applied
+- [ ] Bias check performed
+- [ ] Rating assigned and matches the strictness level
+- [ ] Primary sources found for secondary ones (or marked "not found")
+- [ ] Rejected sources have justification + replacement recommendation
+- [ ] All accepted sources ≥ minimum rating for the strictness level
+
+## Handoff
+
+| Result | Route |
+|--------|-------|
+| All sources verified | → Copywriter (with ratings) + `$fact-checking` (to verify facts from the sources) |
+| Some rejected, replacement found | → Researcher (to replace) → repeat verification of replacements |
+| Some rejected, replacement not found | → Researcher (find alternatives) or → user (decision: remove the fact or find a source) |
+
+When handing off — use `$handoff` with the full report attached.
+
+## Integration with other skills
+
+| Skill | Interaction |
+|-------|-------------|
+| `$topic-research` | **Source:** list of sources for verification |
+| `$fact-checking` | **Consumer:** verified sources → input for fact checking |
+| `$data-storytelling` | **Source:** data from verified sources |
+| `$content-review-checklist` | **Consumer:** item #19 (sources cited) |
+| `$content-release-gate` | **Consumer:** verification mandatory for Release Gate |
+
+## Anti-patterns
+
+| Mistake | Why it's bad | How to do it right |
+|---------|--------------|--------------------|
+| Wikipedia as a source | Wikipedia = ⭐⭐, may contain errors | Use links from Wikipedia → find primary source |
+| "According to studies" without link | Unverifiable, no trust | Specific source: who, when, methodology |
+| One authoritative source = enough | Even Nature has retractions | Cross-check for key data |
+| Corporate report = objective | Conflict of interest | Check bias, find independent confirmation |
+| Retelling instead of primary source | Data distortion through summary chain | Always look for the primary source |
+| All sources given same rating | No differentiation | CRAAP scoring for each, rating ⭐-⭐⭐⭐⭐⭐ |
+| Rejecting for any bias | Bias ≠ falsehood, sometimes biased source has true data | Lower rating + cross-check, don't auto-reject |
+| Old data without verification | World has changed | Currency: ≤ 2 years (tech), ≤ 5 years (science) |
+
+## Output Template
+
+```markdown
+### Source Verification — [Topic]
+
+**Content Type:** [article / post / email]
+**Strictness Level:** [🔴 Maximum / 🟡 Standard / 🔵 Basic]
+**Minimum Acceptable Rating:** [⭐⭐⭐⭐ / ⭐⭐⭐ / ⭐⭐]
+**Total Sources:** [N]
+
+---
+
+#### Verification Results
+
+| # | Source | Type | Author | Date | CRAAP Score | Rating | Bias | Status | Comment |
+|---|--------|------|--------|------|-------------|--------|------|--------|---------|
+| 1 | [name + URL] | Peer-reviewed | [author] | [date] | [N]/25 | ⭐⭐⭐⭐⭐ | None | ✅ Accepted | — |
+| 2 | [name + URL] | Media | [author] | [date] | [N]/25 | ⭐⭐⭐⭐ | None | ✅ Accepted | Cross-confirmed |
+| 3 | [name + URL] | Corporate | [company] | [date] | [N]/25 | ⭐⭐⭐ | 🟡 Commercial | ⚠️ Conditional | Cross-check required |
+| 4 | [name + URL] | Blog | [author] | [date] | [N]/25 | ⭐⭐ | None | ❌ Rejected | Below min rating for 🟡 |
+
+---
+
+#### CRAAP Details (for ⚠️ and ❌)
+
+| # | Source | C (1-5) | R (1-5) | A (1-5) | A (1-5) | P (1-5) | Total | Weak Point |
+|---|--------|---------|---------|---------|---------|---------|-------|------------|
+| 3 | [name] | [N] | [N] | [N] | [N] | [N] | [N]/25 | Purpose: commercial bias |
+| 4 | [name] | [N] | [N] | [N] | [N] | [N] | [N]/25 | Authority: unknown author |
+
+---
+
+#### Bias Report (if detected)
+
+| # | Source | Bias Type | Description | Impact on Rating |
+|---|--------|-----------|-------------|------------------|
+| 3 | [name] | Commercial | [company promotes its product] | ⭐⭐⭐⭐ → ⭐⭐⭐ |
+
+---
+
+#### Summary
+
+| Status | Amount | Sources |
+|--------|--------|---------|
+| ✅ Accepted | [N] | #[list] |
+| ⚠️ Conditional | [N] | #[list] — require cross-check |
+| ❌ Rejected | [N] | #[list] |
+
+**Require Replacement:**
+| # | Rejected | Reason | Replacement Recommendation |
+|---|----------|--------|----------------------------|
+| 4 | [name] | [below min rating] | Find: [source type] on [topic] |
+
+**Primary Sources:**
+| # | Secondary Source | Primary Source Found? | Primary Source URL |
+|---|------------------|-----------------------|--------------------|
+| 2 | [name] | ✅ | [URL] |
+| 3 | [name] | ❌ Not found | — (rating lowered) |
+
+**→ Next Step:** → Copywriter (with ratings) + `$fact-checking` (check facts from accepted sources)
+```

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

@@ -0,0 +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`
+```