takomi 2.1.32 → 2.1.34

package/assets/.agent/skills/photo-book-builder/scripts/revert_organization.py

@@ -0,0 +1,61 @@
+import os
+import shutil
+import json
+import argparse
+
+def revert_organization(workspace_dir):
+    mapping_path = os.path.join(workspace_dir, 'photo_organization_map.json')
+    if not os.path.exists(mapping_path):
+        print(f"Error: Organization mapping file '{mapping_path}' not found. Cannot revert.")
+        return False
+        
+    try:
+        with open(mapping_path, 'r') as f:
+            pages = json.load(f)
+    except Exception as e:
+        print(f"Error reading mapping file: {e}")
+        return False
+        
+    print(f"Reverting files from page folders back to root of: {workspace_dir}")
+    for page_num, files in pages.items():
+        page_dir = os.path.join(workspace_dir, f"page {page_num}")
+        for filename in files:
+            src = os.path.join(page_dir, filename)
+            dst = os.path.join(workspace_dir, filename)
+            if os.path.exists(src):
+                try:
+                    shutil.move(src, dst)
+                except Exception as e:
+                    print(f"Error moving {filename} to root: {e}")
+            elif os.path.exists(dst):
+                # File is already at root
+                pass
+            else:
+                print(f"Warning: File {filename} not found in {page_dir} or {workspace_dir}!")
+                
+        # Remove page directory if empty
+        if os.path.exists(page_dir):
+            try:
+                if not os.listdir(page_dir):
+                    os.rmdir(page_dir)
+                    print(f"Removed empty directory: {page_dir}")
+                else:
+                    print(f"Warning: Directory {page_dir} is not empty, keeping it.")
+            except Exception as e:
+                print(f"Error removing directory {page_dir}: {e}")
+                
+    try:
+        os.remove(mapping_path)
+        print("Removed organization map file.")
+    except Exception as e:
+        print(f"Error removing mapping file: {e}")
+        
+    print("Revert complete!")
+    return True
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(description="Revert photo organization back to a flat source directory.")
+    parser.add_argument("--workspace-dir", required=True, help="Path to the workspace containing page folders.")
+    args = parser.parse_args()
+    
+    revert_organization(args.workspace_dir)

package/assets/.agent/skills/photo-book-builder/scripts/upscale_covers.py

@@ -0,0 +1,47 @@
+import os
+import argparse
+from PIL import Image
+
+def upscale_image(src_path, out_path, target_w, target_h, quality=95):
+    if not os.path.exists(src_path):
+        print(f"Error: Source image '{src_path}' does not exist!")
+        return False
+        
+    print(f"Loading image: {src_path}")
+    try:
+        with Image.open(src_path) as img:
+            print(f"Original size: {img.size}")
+            # Ensure target size is tuple of ints
+            target_size = (int(target_w), int(target_h))
+            print(f"Upscaling to: {target_size} using Resampling.LANCZOS...")
+            
+            # Use LANCZOS for high quality down/up sampling
+            resized = img.resize(target_size, Image.Resampling.LANCZOS)
+            
+            # Determine format from extension
+            ext = os.path.splitext(out_path)[1].lower()
+            save_format = "JPEG" if ext in ['.jpg', '.jpeg'] else "PNG"
+            
+            # Save the file
+            os.makedirs(os.path.dirname(os.path.abspath(out_path)), exist_ok=True)
+            if save_format == "JPEG":
+                resized.convert("RGB").save(out_path, "JPEG", quality=quality)
+            else:
+                resized.save(out_path, "PNG")
+                
+            print(f"Successfully saved upscaled image to: {out_path}")
+            return True
+    except Exception as e:
+        print(f"Error upscaling image: {e}")
+        return False
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Upscale cover artwork to target print dimensions using LANCZOS.")
+    parser.add_argument("--src", required=True, help="Path to the source image.")
+    parser.add_argument("--out", required=True, help="Output file path.")
+    parser.add_argument("--width", type=int, required=True, help="Target width in pixels.")
+    parser.add_argument("--height", type=int, required=True, help="Target height in pixels.")
+    parser.add_argument("--quality", type=int, default=95, help="JPEG quality if output is JPEG (default: 95).")
+    args = parser.parse_args()
+    
+    upscale_image(args.src, args.out, args.width, args.height, args.quality)

package/assets/.agent/skills/youtube-pipeline/SKILL.md

@@ -5,7 +5,7 @@ description: Complete YouTube video production pipeline from ideation to distrib
 
 # YouTube Pipeline Skill
 
-This skill provides access to the complete YouTube video production pipeline. When activated, read the workflow files in the user's vault for the full, up-to-date instructions.
+This skill provides access to a complete YouTube video production pipeline. It is self-contained: when activated, resolve the folder containing this `SKILL.md` as `<skill-root>` and read the bundled workflow, knowledge, prompt, and script files from there.
 
 ## Quick Reference
 
@@ -21,41 +21,32 @@ This skill provides access to the complete YouTube video production pipeline. Wh
 
 ---
 
-## Source Files (Always Read These First)
-
-The workflow docs are bundled in this skill's `resources/` folder for quick access:
-
-**Workflow Files (Local):**
-```
-.agent/skills/youtube-pipeline/resources/youtube-pipeline.md
-.agent/skills/youtube-pipeline/resources/youtube-phase1-strategy.md
-.agent/skills/youtube-pipeline/resources/youtube-phase2-packaging.md
-.agent/skills/youtube-pipeline/resources/youtube-phase3-scripting.md
-.agent/skills/youtube-pipeline/resources/youtube-phase3.5-shorts.md
-.agent/skills/youtube-pipeline/resources/youtube-phase4-production.md
-.agent/skills/youtube-pipeline/resources/youtube-phase5-repurposing.md
-```
-
-**Source of Truth (User's Vault):**
-If you need to sync or check for updates, the authoritative files are:
-```
-c:\CreativeOS\Creator_Command_Hub_Obsidian\📁 YouTube Brain\.agent\workflows\
-c:\CreativeOS\Creator_Command_Hub_Obsidian\📁 YouTube Brain\📂 Processed_Notes\Workflow\
-```
-
-**Prompts (For External AI Use):**
-```
-c:\CreativeOS\Creator_Command_Hub_Obsidian\📁 YouTube Brain\📝 01-Prompt\Transcription Extraction Prompt v2.md
-c:\CreativeOS\Creator_Command_Hub_Obsidian\📁 YouTube Brain\📝 01-Prompt\Video QA Prompt.md
-c:\CreativeOS\Creator_Command_Hub_Obsidian\📁 YouTube Brain\📝 01-Prompt\Title Thumbnail Picker Prompt.md
-c:\CreativeOS\Creator_Command_Hub_Obsidian\📁 YouTube Brain\📝 01-Prompt\Shorts Bridge Protocol.md
-```
-
-**Automation Scripts (Phase 1):**
-```
-.agent/skills/youtube-pipeline/scripts/parse_yt_studio.ps1  # Parse YT Studio Inspiration HTML
-.agent/skills/google-trends/scripts/search.js               # Google Trends CLI (separate skill)
-```
+## Bundled Files (Always Read These First)
+
+All runtime instructions are bundled in this skill. Do not require the user's vault, a global config folder, or a specific agent harness for normal use.
+
+**Workflow Files:**
+```
+<skill-root>/resources/youtube-pipeline.md
+<skill-root>/resources/youtube-phase1-strategy.md
+<skill-root>/resources/youtube-phase2-packaging.md
+<skill-root>/resources/youtube-phase3-scripting.md
+<skill-root>/resources/youtube-phase3.5-shorts.md
+<skill-root>/resources/youtube-phase4-production.md
+<skill-root>/resources/youtube-phase5-repurposing.md
+```
+
+**Knowledge And Prompts:**
+```
+<skill-root>/resources/knowledge/
+<skill-root>/resources/prompts/
+```
+
+**Automation Scripts (Phase 1):**
+```
+<skill-root>/scripts/parse_yt_studio.ps1
+<skill-root>/scripts/google-trends/search.js
+```
 
 ---
 
@@ -70,18 +61,31 @@ Extracts topics and volume indicators from YouTube Studio's Inspiration tab.
 3. Right-click → Copy → Copy outerHTML
 4. Paste into `.html` file
 
-**Agent Command:**
-```powershell
-powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.gemini\antigravity\skills\youtube-pipeline\scripts\parse_yt_studio.ps1" -InputFile "topic.html" -OutputFile "parsed.md"
-```
-
-### Google Trends CLI
-Uses the separate `google-trends` skill for automated trend searching.
-
-**Agent Command:**
-```powershell
-node "$env:USERPROFILE\.gemini\antigravity\skills\google-trends\scripts\search.js" -k "Claude Cowork" -p youtube -t "now 7-d"
-```
+**Agent Command:**
+```powershell
+$SkillRoot = "<path-to-installed-youtube-pipeline-skill>"
+powershell -ExecutionPolicy Bypass -File (Join-Path $SkillRoot "scripts/parse_yt_studio.ps1") -InputFile "topic.html" -OutputFile "parsed.md"
+```
+
+### Google Trends Research
+Google Trends validation is required. This skill bundles the local `google-trends` Node CLI so agents can run trends checks without relying on a separate global skill install.
+
+**First-Time Setup:**
+```powershell
+$SkillRoot = "<path-to-installed-youtube-pipeline-skill>"
+$TrendRoot = Join-Path $SkillRoot "scripts/google-trends"
+Push-Location $TrendRoot
+pnpm install
+Pop-Location
+```
+
+**Agent Command:**
+```powershell
+$SkillRoot = "<path-to-installed-youtube-pipeline-skill>"
+node (Join-Path $SkillRoot "scripts/google-trends/search.js") -k "Claude Cowork" -p youtube -t "now 7-d"
+```
+
+If Node dependencies are unavailable, use the manual Google Trends workflow in `resources/youtube-phase1-strategy.md`. Do not assume a Gemini, Codex, Pi, or other harness-specific path.
 
 ## How to Use This Skill
 
@@ -178,17 +182,24 @@ These are embedded in the Phase 3 workflow but summarized here for reference:
 
 ---
 
-## Updating This Skill
-
-The workflow files in `resources/` are copies. The source of truth is the user's vault.
-
-**To Sync (PowerShell):**
-```powershell
-Copy-Item -Path "C:\CreativeOS\Creator_Command_Hub_Obsidian\📁 YouTube Brain\.agent\workflows\youtube-*.md" -Destination "$env:USERPROFILE\.gemini\antigravity\skills\youtube-pipeline\resources\" -Force
-```
-
-**When to Sync:**
-- After updating any workflow in the vault
-- After adding new phases
-
-To add new phases: First create in the vault's `.agent/workflows/`, then sync here.
+## Updating This Skill
+
+The files in `resources/` are the packaged source used at runtime. If you refresh them from another workspace, copy into this skill folder and keep all references relative to `<skill-root>`.
+
+**To Sync (PowerShell):**
+```powershell
+$SkillRoot = "<path-to-installed-youtube-pipeline-skill>"
+$ExternalWorkflowDir = "<path-to-external-workflow-source>"
+$ExternalKnowledgeDir = "<path-to-external-knowledge-source>"
+$ExternalPromptDir = "<path-to-external-prompt-source>"
+
+Copy-Item -Path (Join-Path $ExternalWorkflowDir "youtube-*.md") -Destination (Join-Path $SkillRoot "resources") -Force
+Copy-Item -Path (Join-Path $ExternalKnowledgeDir "*.md") -Destination (Join-Path $SkillRoot "resources/knowledge") -Force
+Copy-Item -Path (Join-Path $ExternalPromptDir "*.md") -Destination (Join-Path $SkillRoot "resources/prompts") -Force
+```
+
+**When to Sync:**
+- After updating any external workflow, processed note, or prompt source.
+- To add new phases, add the workflow to `resources/`, add supporting knowledge/prompts if needed, and update this `SKILL.md` quick reference.
+- If the Google Trends CLI changes, refresh `scripts/google-trends/search.js`, `package.json`, and `pnpm-lock.yaml` together.
+- After syncing, run a reference check for absolute local paths and harness-specific install paths.

package/assets/.agent/skills/youtube-pipeline/resources/knowledge/Application.md

@@ -0,0 +1 @@
+Now, I think the last thing that I really want to talk about here is I don't have to do it. Oh, by the way, oh, yeah, okay, another, the last thing we talk about particular is going to have to do with, um, providing building an application that helps us manage it. It's kind of like a content management system. So from the scripting to decide to Chrome news, I can upload Chrome news there, visualize them, whatever, whatever, talk to the AI there, or just like copy and paste things there, generate sounds, so it have like proper workflow. And also, most importantly, I think the most important thing there is to be able to know why I make certain decisions. Like, okay, I can say that, okay, this video, I made it because I saw it was trending on Google Trends, and then I was able to release it on time, or I saw it because of this other category or whatever. So that way, we can know what sources give us what kind of results. Just that we can also look at, like, take pictures of the YouTube graph and look at, okay, what's interest actually resonates better with the audience, what's this, does this, what's this. So I'm thinking, like, this is probably, I think it's nice to document it, and I just plan ahead for it, generate sounds. So turning this whole workflow, whatever it's gonna be, so like all the different phases of it, turning it all into five phases, seven phases, eight phases, into like a YouTube workflow, I make an application on it. So that way, I can have like a proper pipeline that's tried and tested. There was a time I used to, I used to check Reddit. It was going to be like, okay, check Reddit to see what's trending on Reddit to, that kind of thing. But I don't really know if there's a point of danger Reddit one since I already have the other ones that are really good. Whatever. So anyway, that's just something I wanted to say. So it's just like to automate the whole process, because when you can automate it, you can be able to replicate success, generate a kind of thing. You can refine strategies and see that, okay, this one is cool, but it doesn't really work with me particularly, generate and what I'm saying. So, yeah.

package/assets/.agent/skills/youtube-pipeline/resources/knowledge/Phase 1.md

@@ -0,0 +1,86 @@
+# Phase 1: The Strategy Engine (Ideation & Research)
+
+**Objective:** To generate and select a video topic that is mathematically probable to succeed by leveraging data rather than intuition.
+
+**The Golden Rule:** Do not reinvent the wheel; improve the rim. We are looking for "Outliers"—videos that are statistically performing significantly better than a channel’s average.
+
+---
+
+## Step 1: Input Sources (The "Outlier" Scavenger Hunt)
+
+You need to populate a raw list of potential ideas. Do not filter yet; focus on volume. You are looking for **Proven Concepts** in four specific areas.
+
+### 1. Small Creators (The "Gold Mine")
+*   **Logic:** If a channel with 2,000 subscribers has a video with 50,000 views, the *idea* is carrying the weight, not the creator's fame.
+*   **The Metric:** Look for videos with **5x - 10x** the views of the channel’s subscriber count.
+*   **Action:**
+    *   Search your niche keywords.
+    *   Filter by "View Count" (or use a tool like ViewStats/1of10).
+    *   Scan for channels with low sub counts but high video views.
+
+### 2. Big Creators (The "Trend Setters")
+*   **Logic:** These creators dictate what the broad market is currently interested in.
+*   **The Metric:** Look for their "Most Popular" videos or recent videos performing above their average baseline (e.g., a 2M sub channel usually gets 500k views, but one video got 1.5M).
+*   **Action:** Go to the top 5 giants in your niche $\rightarrow$ Sort by "Popular" $\rightarrow$ Note the recurring topics.
+
+### 3. Adjacent Niches (The "Remix")
+*   **Logic:** Topics that are cousins to your niche. The audience is the same, but the angle is different.
+*   **Example:** If you are in "Cold Email" (B2B Sales), look at "Facebook Ads" (Marketing).
+*   **Action:** Find a high-performing format in an adjacent niche and ask: *"How can I plug my topic into this format?"*
+
+### 4. Broad Niches (The "Mass Appeal")
+*   **Logic:** General topics (Productivity, Wealth, Health) that appeal to everyone.
+*   **Action:** Look for broad formats (e.g., "I tried X for 30 Days") and apply your niche (e.g., "I tried Cold Calling for 30 Days").
+
+---
+
+## Step 2: The Archetype Filter
+
+Once you have a list of ideas, categorize them into one of these proven formats. If an idea doesn't fit a format, it is likely to fail.
+
+1.  **The Listicle:** "7 Ways to..." / "10 Mistakes..." (Clean, predictable value).
+2.  **The Story/Transformation:** "How I went from [Pain] to [Desire]" (Emotional journey).
+3.  **The Bold Challenge:** "I tried [Hard Thing] for [Timeframe]" (High stakes, built-in narrative).
+4.  **The Contrarian/Negative:** "Stop doing [Popular Thing]" / "Why [X] is Dead" (Triggers fear/loss aversion).
+5.  **The Case Study:** "How [Famous Person] Did [Result]" (Fame-jacking/Authority).
+
+---
+
+## Step 3: Validation Research (The "Data Dive")
+
+Before committing to an idea, you must validate that the market actually wants it *right now* and identify the "Gap" you will fill.
+
+### 1. The Comment Section Scraping
+Go to the "Outlier" videos you found in Step 1. Read the top 50 comments.
+*   **Look for Questions:** What are people confused about? (This becomes your value prop).
+*   **Look for Hate:** What did the creator get wrong? (This is your opportunity to do it better).
+*   **Look for Praise:** What specific moment or tip did they love? (You must include this).
+
+### 2. Market Cap Check (Google Trends)
+*   Go to Google Trends.
+*   Filter for **"YouTube Search"**.
+*   Input the main keywords of your video idea.
+*   **The Goal:** Ensure the trend line is flat or rising. If it is crashing (e.g., "NFTs" in 2024), kill the idea immediately.
+
+---
+
+## Step 4: The Selection Funnel (100 $\rightarrow$ 1)
+
+This is the final decision gate. You should have a list of ideas. Run them through this funnel.
+
+*   **The 100 List:** Start with 100 raw ideas/titles based on Step 1.
+*   **The Top 20:** Remove duplicates, boring topics, and declining trends.
+*   **The Top 10:** Apply the **"Packaging Test"** (see below).
+*   **The 1:** The winner.
+
+### **The Packaging Test (Crucial Pass/Fail)**
+Before writing a script, ask yourself: **"Can I visualize the Title and Thumbnail for this?"**
+*   *If you cannot imagine a clickable title and thumbnail instantly, the idea is bad. Discard it.*
+*   The video is the "Mouse Trap," but the Idea/Packaging is the "Cheese." If the cheese isn't smelly enough, no one enters the trap.
+
+### **Output of Phase 1**
+By the end of this phase, you should have **One Video Concept** defined by:
+1.  **The Topic:** (e.g., Cold Email Outreach).
+2.  **The Format:** (e.g., The Bold Challenge).
+3.  **The Proven Outlier:** (Link to the reference video that proves this works).
+4.  **The Market Gap:** (One sentence on what you will do differently/better than the reference).

package/assets/.agent/skills/youtube-pipeline/resources/knowledge/Phase 2.md

@@ -0,0 +1,106 @@
+# Phase 2: The Packaging Lab (Title & Thumbnail)
+
+**Objective:** To manufacture a "Click Event" by creating a curiosity gap that is physically painful to ignore.
+**The Principle:** The Video is the Trap. The Title and Thumbnail are the Cheese. If the cheese isn't irresistible, the quality of the trap doesn't matter.
+
+---
+
+## Step 1: The Concept Validation (The "Why" Filter)
+Before designing, you must clarify the psychological hook. Answer these 4 questions from the *Scripting Framework*:
+1.  **Avatar:** Who exactly is this for?
+2.  **Objection:** What does the viewer *think* they know that this video challenges?
+3.  **Stakes:** What do they lose if they scroll past? (FOMO, Loss Aversion).
+4.  **Transformation:** What is the specific "Dream Outcome"?
+
+---
+
+## Step 2: Title Engineering (The Copy)
+Do not write one title. Write 10. Use these formulas derived from the *Creator Hooks* and *Outlier* documents.
+
+### The 3 Core Drivers (Select One)
+Every viral title leans on one of these pillars:
+1.  **Curiosity (The Gap):** "I Bought a Secret House"
+2.  **Negativity (Fear/Pain):** "7 Mistakes That Kill Your Channel"
+3.  **Desire (Benefit/Speed):** "How to Get Abs in 20 Days"
+
+### The 10 Proven Title Archetypes (The Menu)
+*Select one framework to structure your title:*
+1.  **The Open Loop:** "The Entire NBA FEARS This Play" (Gap: What is the play?)
+2.  **The Counterintuitive:** "Do NOT Shut Down Your Computer (Here's Why)" (Challenges belief).
+3.  **The Secret:** "The Money Rule I Learned in Japan."
+4.  **The Extreme:** "I Survived 50 Hours in A Nuclear Bunker."
+5.  **The Negative List:** "5 Things You Should NEVER Tell Coworkers."
+6.  **The Constraint:** "I Built a Bunker Using ONLY a Spoon."
+7.  **The Future:** "AI Will Replace These Jobs by 2025."
+8.  **The Contrast:** "How This Dumb Product Made $1,000,000" (Dumb vs. Rich).
+9.  **The Question:** "Why is Nobody Talking About [X]?"
+10. **The Weird:** "10 Odd Dog Behaviors Explained."
+
+### The "Clickbait Dial" Check
+*   **Rule:** If you deliver on the promise, it is not clickbait; it is good marketing.
+*   **Adjustment:** If the title feels too "hype," dial it down. If it feels boring, add an extreme adjective (e.g., change "bad" to "catastrophic").
+
+---
+
+## Step 3: Thumbnail Architecture (The Visuals)
+*Source: The Top 100 Thumbnails & Thumbnail Guide.*
+
+**The Golden Rule:** **Storyboard First.** Do not open Photoshop until you have sketched the concept.
+
+### 1. Select The Thumbnail Type
+Choose the format that fits the Title Archetype:
+*   **The Moment:** The split second before disaster (e.g., a ball about to hit a face).
+*   **The Result:** The final dream outcome (e.g., a finished tiny home).
+*   **The Transformation:** The classic Split Screen (Before vs. After).
+*   **The Comparison:** Two objects head-to-head (Cheap vs. Expensive).
+*   **The Novelty:** A weird object no one has seen before (e.g., A transparent burger).
+
+### 2. The 3 C's of Design
+*   **Contents:** Limit to **3 elements max**. (e.g., Face, Object, Background).
+*   **Composition:**
+    *   **Rule of Thirds:** Place eyes/objects on the grid lines.
+    *   **Leading Lines:** Use arrows or arms to point at the focal point.
+*   **Contrast:**
+    *   **Color Wheel:** Use complementary colors (Blue background + Orange shirt; Green background + Red arrow).
+    *   **Luminosity:** Bright foreground on a dark background (or vice versa).
+
+### 3. The "Scroll Stoppers" (Visual Hooks)
+Include **1 or 2** of these elements to arrest attention:
+*   **Face with High Emotion:** Shock, Fear, Disgust, Joy.
+*   **The "Red Arrow":** Directs the eye to the mystery.
+*   **Large Numbers/Money:** "$1,000,000" or "Day 1 vs Day 30."
+*   **Danger:** Fire, Police, Warning signs.
+*   **Blur/Pixelation:** Hiding the key element to force a click.
+
+### 4. Text & Fonts
+*   **Rule:** Max 4-5 words. Do **NOT** repeat the title.
+*   **Function:** The text should answer "What?" or add context (e.g., Title: "I Survived an Island" $\rightarrow$ Thumb Text: "0 Food").
+*   **Approved Fonts:** Nexa, Kallisto, Eastman Roman, Berlin Rounded, HammerBro101.
+
+---
+
+## Step 4: The Synergy Check (The 1+1=3 Rule)
+The Title and Thumbnail must talk to each other, not repeat each other.
+
+*   **Bad Synergy:**
+    *   Title: "I Painted My Room Blue"
+    *   Thumb: Picture of blue room + Text: "Blue Room"
+*   **Good Synergy:**
+    *   Title: "I Made a Huge Mistake..." (The Setup)
+    *   Thumb: Picture of a blue room covered in paint splatters + Face Palm (The Context/Payoff).
+
+---
+
+## Step 5: The Quality Assurance (Pass/Fail)
+
+Before moving to Phase 3 (Scripting), the packaging must pass these 4 tests:
+
+1.  **The Glance Test:** Can a stranger understand the concept in **2 seconds**?
+2.  **The 18% Rule:** Shrink the image to 18% size (mobile view). Is the main element still visible?
+3.  **The Competitor Test:** Put it next to the top 3 videos in your niche. Does yours pop more?
+4.  **The "Grandma" Test:** Would your grandma be curious, or just confused? (Confusion kills clicks).
+
+### **Advanced Optimization: The MrBeast Method**
+If you have the resources (or AI tools), generate variations:
+1.  **Macro Test:** Test 3 completely different concepts (e.g., Concept A: Face close up. Concept B: Wide shot of action. Concept C: 3D render).
+2.  **Micro Test:** Once you find the winner, test small tweaks (Red shirt vs. Blue shirt, Mouth open vs. Mouth closed).

package/assets/.agent/skills/youtube-pipeline/resources/knowledge/Phase 3.md

@@ -0,0 +1,112 @@
+# Phase 3: The Scripting Forge (Retention & Psychology)
+
+**Objective:** To hold the viewer’s attention from 0:00 to the very last second by systematically opening and closing curiosity gaps.
+**The Principle:** A script is not a lecture; it is a **Dopamine Machine**. Every sentence must either build tension, provide value, or move the story forward. If it does neither, delete it.
+
+---
+
+## Part 1: The Hook (0:00 – 0:45)
+*Goal: 60%+ Retention at the 30-second mark.*
+
+Do not "welcome" them back to the channel. Do not introduce yourself yet. You must immediately validate the click and hook them emotionally.
+
+### The 4-Step Hook Structure
+
+**1. The "First Frame" Statement (0:00-0:05)**
+*   **Visual:** Must match the thumbnail immediately (Visual Validation).
+*   **Audio:** A "Scroll Stopper" line. Select one **Hook Template** based on your video type (Updated with *Ego Traps*):
+    *   **The Ego Trap (Cognitive Dissonance):** "You think doing [X] is helping you, but it’s actually the reason you are failing." (Make them feel wrong).
+    *   **The Challenge:** "I tried [Hard Thing] for 30 Days to prove it’s not luck."
+    *   **The Action:** "Here is how to hack your [Metric] in 2024."
+    *   **The Secret:** "The UGLY truth of [Topic] you don’t see."
+    *   **The Negative Warning:** "Stop doing [Popular Habit] immediately."
+    *   **The Story Start:** "I was $\$150,000$ in debt..."
+
+**2. The Context & Stakes (0:05-0:15)**
+*   Explain *why* this matters right now.
+*   **The Cost of Inaction (FOMO):** Instead of just promising a benefit, highlight the pain of staying the same.
+    *   *Script:* "If you ignore this, you will continue [Current Pain] while your competitors [Gain Advantage]."
+    *   *Psychology:* Viewers fear being left behind more than they desire getting ahead.
+
+**3. The "Input Bias" Flex (0:15-0:30)**
+*   *Crucial Step.* Show the viewer that you worked harder than they ever could, so they "owe" you their attention.
+*   **Script Template:** "I spent [5 Months / $10,000 / 100 Hours] analyzing [Topic] so you don't have to."
+
+**4. The Payoff Promise (0:30-0:45)**
+*   Tell them exactly what they will get by the end.
+*   **The "3 Steps" Rule:** "I’ve boiled it down to 3 simple steps..." (This makes the video feel digestible).
+
+---
+
+## Part 2: The Body (The Loop Architecture)
+*Goal: To prevent the "Mid-Video Dip."*
+
+Do not write a linear list of tips. Structure the body as a chain of **Open Loops**.
+
+### The "DISC" Layering Framework
+*Use this for every major point to appeal to ALL personality types.*
+Don't just give data (bores the emotional viewer) or just stories (annoys the analytical viewer). Layer your evidence:
+1.  **D (Dominant):** The Bottom Line. *"This strategy generated $40k in 7 days."*
+2.  **I (Influential):** The Story/Emotion. *"I felt completely hopeless until I made this switch."*
+3.  **S (Steady):** The Step-by-Step. *"We’re going to walk through this click-by-click."*
+4.  **C (Conscientious):** The Data/Logic. *"According to a study of 1M users, this increases retention by 42%."*
+
+### The "Loop Cycle" (Repeat for each Main Point)
+Treat every section of your video as a mini-video.
+1.  **Open Loop:** Start with a question or a "knowledge gap."
+    *   *Example:* "But knowing [Point A] isn't enough, unless you fix the one mistake that kills 90% of beginners..."
+2.  **The Content (The Meat):** Deliver the value using the **DISC Layers**.
+    *   *Assumptive Questions:* Write your bullet points as questions the viewer is asking in their head.
+3.  **The 30-Second Snap (Pacing):** Every 30 seconds, you need a "Reset" to snap attention back.
+    *   *Action:* Shift energy, change the angle, insert a meme/pattern interrupt, or make a bold statement.
+4.  **The Payoff:** Close the loop (Answer the question).
+5.  **The Transition (The Bridge):** Immediately open the *next* loop. Do not pause.
+    *   *Bad Transition:* "Okay, next is tip number 2."
+    *   *Good Transition:* "Now that you've fixed your title, your thumbnail will actually fail if you don't use this color psychology..."
+
+---
+
+## Part 3: The Refinement Checklist (The Polish)
+*Source: "Run Your Scripts Through This" PDF.*
+
+Once the draft is written, run it through this filter. If it fails, rewrite.
+
+**The "Psychology" Test**
+*   [ ] **Ego Check:** Did I make the viewer feel slightly "wrong" or "at risk" in the first 60 seconds?
+*   [ ] **DISC Scan:** Does the script have Stories (I), Stats (C), Results (D), and Steps (S)?
+*   [ ] **Loss Aversion:** Did I explain the *painful cost* of not watching this video?
+
+**The "Grade 5" Test**
+*   [ ] Is the language incredibly simple? (Aim for 5th Grade reading level).
+*   [ ] Are there any "Fancy Words"? (Replace "utilize" with "use", "concept" with "idea").
+*   [ ] Is there Jargon? (If you must use it, explain it instantly).
+
+**The "Value" Test**
+*   [ ] Would you pay $100 for the information in this script?
+*   [ ] Did you "Collapse the Story"? (Cut the fluff. Get to the action).
+*   [ ] Is it actionable? (Can the viewer *do* something immediately after watching?)
+
+**The "Dopamine" Test**
+*   [ ] **The 30s Ruler:** Are there any blocks of text longer than 30 seconds without a note for a "Reset" or "Scene Change"?
+*   [ ] Is there a visual cue written for every paragraph? (B-Roll, Graph, Screen Recording).
+
+---
+
+## Part 4: The Outro (The Conversion)
+*Goal: Click-Through Rate (CTR) to the next video.*
+
+**The Cardinal Sin:** Do NOT say "In conclusion," "That's it for today," or "Thanks for watching." This signals the viewer to leave.
+
+### The "Bridge" Strategy
+1.  **Link the Problem:** Mention a problem that the *current* video created or didn't solve.
+2.  **The Solution:** Pitch your *next* video as the specific solution to that problem.
+3.  **The CTA:** "If you want to [Solve New Problem], you need to watch this video next." (Point to screen).
+
+---
+
+## Summary: The Scripting Workflow
+1.  **Brainstorm:** Dump all knowledge into a doc.
+2.  **Structure:** Organize into the **Loop Cycle** (Open Loop $\to$ DISC Content $\to$ Payoff).
+3.  **Hook:** Write the **4-Step Hook** (Ego Trap, Cost of Inaction, Input Bias, Promise).
+4.  **Refine:** Apply the **30-Second Snap** and **Psychology Test**.
+5.  **Visuals:** Add cues for the editor (See Phase 4).