Social Media Content Generator

Quick Start

After generating content, validate and format output:

python3 ${CLAUDE_PLUGIN_ROOT}/lib/format_social_json.py < output.txt > output.json

Structured Output Format

All content deliverables must be output with clear markdown section headers for automated parsing. Use the following header structure exactly:

## CTA KEYWORD
[KEYWORD]

## ENGLISH SCRIPT
Hi, I'm Sofia...

## SPANISH SCRIPT
Hola, soy Sofía...

## HEYGEN LOOK
Name: [Look Name]
Prompt: [Full image prompt]
Animation: [Animation Name]
Tone: [detected tone]

## FULL DESCRIPTION (ENGLISH)
[Complete Facebook/Instagram/TikTok/YouTube description]

## FULL DESCRIPTION (SPANISH)
[Complete Facebook/Instagram/TikTok/YouTube description]

## THREADS (ENGLISH)
[Threads description ≤500 chars]

## THREADS (SPANISH)
[Threads description ≤500 chars]

## BLUESKY (ENGLISH)
[Bluesky description ≤300 chars]

## BLUESKY (SPANISH)
[Bluesky description ≤300 chars]

## YOUTUBE TITLE (ENGLISH)
1. [Title option 1]
2. [Title option 2]
3. [Title option 3]

## YOUTUBE TITLE (SPANISH)
1. [Título opción 1]
2. [Título opción 2]
3. [Título opción 3]

This structured format allows the Python post-processor to reliably extract and validate each field. Always use these exact headers in your output.

Transform raw content into complete, production-ready social media packages for HeyGen avatar videos featuring Sofia.

Core Workflow

Step 1: Content Analysis

Extract from input:

• Core topic/insight: Main takeaway
• Key data points: Numbers, percentages, dates
• Content tone: Classify as one of: urgent, educational, celebratory, conversational, authoritative, relatable
• Audience relevance: Who cares and why
• CTA Keyword: Generate a trackable keyword (see CTA Keyword System below)

---

CTA Keyword System

Every content package includes a trackable DM keyword that viewers use to engage. This enables lead tracking and personalized follow-up.

Keyword Generation Rules

1. Maximum 5 characters (letters only, no numbers or symbols)
2. ALL CAPS for visibility
3. Memorable and relevant to the content topic
4. Unique per content piece to track performance

Keyword Selection Matrix

Content Topic	Example Keywords
Credit/Score	SCORE, FICO, CRED
Rates/Interest	RATE, RATES, LOW
First-time buyers	FIRST, START, NEW
Refinance	REFI, SAVE, CASH
Down payment	DOWN, DPA, HELP
Pre-approval	PRE, READY, APP
Market updates	NEWS, UPDATE, NOW
Home buying tips	TIPS, GUIDE, HOW
Affordability	AFFORD, BUDGET, PLAN
Investment/Equity	EQUITY, BUILD, GROW
VA/FHA loans	VA, FHA, HERO
Closing costs	CLOSE, COSTS, FEES

CTA Phrasing Templates

For Scripts (spoken):

• English: "DM me the word [KEYWORD] to get started."
• English: "Comment [KEYWORD] below and I'll reach out."
• English: "Call us or DM [KEYWORD] for your free consultation."
• Spanish: "Envíame un DM con la palabra [KEYWORD] para comenzar."
• Spanish: "Comenta [KEYWORD] abajo y te contacto."
• Spanish: "Llámanos o envía [KEYWORD] por DM para tu consulta gratis."

For Descriptions (written):

• "📲 DM "[KEYWORD]" to get started"
• "💬 Comment "[KEYWORD]" for more info"
• "📞 Call or DM "[KEYWORD]" for your free consult"
• "📲 Envía "[KEYWORD]" por DM para empezar"
• "💬 Comenta "[KEYWORD]" para más información"
• "📞 Llama o envía "[KEYWORD]" por DM"

---

Step 2: Generate All 12 Deliverables

Deliverable 0: CTA Keyword Assignment

Before generating any content, assign the keyword:

**CTA Keyword:** [KEYWORD]
**Rationale:** [Why this keyword fits the content]

Deliverable 1: English Script (≤20 seconds)

Structure:

Hi, I'm Sofia. [Hook - 1 sentence]
[Core insight - 1-2 sentences with key data]
[CTA with keyword - 1 sentence]

Guidelines:

• Maximum 50-54 words (160 WPM)
• Numbers written for speech: "six-point-two" not "6.2"
• Natural conversational tone
• End with clear CTA using the assigned keyword

CTA Examples for Scripts:

• "DM me the word SCORE to check your options."
• "Comment RATE below and I'll send you the details."
• "Call us or DM FIRST to get started today."

Deliverable 2: Spanish Script (≤20 seconds)

Structure:

Hola, soy Sofía. [Gancho - 1 oración]
[Información clave - 1-2 oraciones]
[CTA con palabra clave - 1 oración]

Guidelines:

• Maximum 46-50 words (145 WPM)
• Latin American Spanish (neutral)
• Mirror meaning, not word-for-word
• End with clear CTA using the same keyword

CTA Examples for Scripts:

• "Envíame un DM con la palabra SCORE para revisar tus opciones."
• "Comenta RATE abajo y te envío los detalles."
• "Llámanos o envía FIRST por DM para comenzar hoy."

Deliverable 3: English Video Description

Format:

[Emoji] [Hook question/statement]...
[2-3 sentences expanding insight] [emoji] [emoji]
[Why it matters to viewer]

📲 DM "[KEYWORD]" to get started
📞 Call for your free consultation
💬 Comment "[KEYWORD]" below for more info

#Tag1 #Tag2 #Tag3 #Tag4 #Tag5 #Tag6 #Tag7 #Tag8

Deliverable 4: Spanish Video Description

Same structure, culturally adapted with bilingual hashtags:

[Emoji] [Gancho pregunta/declaración]...
[2-3 oraciones expandiendo información] [emoji] [emoji]
[Por qué le importa al espectador]

📲 Envía "[KEYWORD]" por DM para empezar
📞 Llama para tu consulta gratis
💬 Comenta "[KEYWORD]" abajo para más info

#Tag1 #Tag2 #Tag3 #Tag4 #Tag5 #Tag6 #Tag7 #Tag8

Deliverable 5: Threads Description — English (≤500 characters)

Format:

[Emoji] [Strong hook - 1 sentence]
[Core insight condensed - 1-2 sentences]
📲 DM "[KEYWORD]" to learn more
[3-4 hashtags]

Guidelines:

• Maximum 500 characters including spaces
• Prioritize the hook and key insight
• Include DM keyword CTA
• 3-4 hashtags maximum
• No line breaks between sentences (save characters)

Deliverable 6: Threads Description — Spanish (≤500 characters)

Same structure as English Threads, culturally adapted:

• Maximum 500 characters including spaces
• Latin American Spanish (neutral)
• Include DM keyword CTA
• Mix of English and Spanish hashtags for reach

Deliverable 7: Bluesky Description — English (≤300 characters)

Format:

[Emoji] [Punchy hook] [Core fact/insight] DM "[KEYWORD]" to learn more.

Guidelines:

• Maximum 300 characters including spaces
• Ultra-concise — every word must earn its place
• No hashtags (Bluesky doesn't use them effectively)
• Include brief DM keyword CTA
• Can use 1-2 emojis strategically

Deliverable 8: Bluesky Description — Spanish (≤300 characters)

Same structure as English Bluesky:

• Maximum 300 characters including spaces
• Latin American Spanish (neutral)
• No hashtags
• Include brief DM keyword CTA
• Prioritize natural phrasing over direct translation

Deliverable 9: English YouTube Shorts Titles

• Maximum 100 characters
• Start with emoji
• Include specificity (numbers/dates)

Formats:

• Informational: 📉 [Topic] [Data] — [Timeframe/Relevance]
• Hook-driven: [Question] — Is [Outcome] Coming?
• Punchy: [Topic] [Data] — [Signal/Implication]

Deliverable 10: Spanish YouTube Shorts Titles

• Maximum 100 characters
• Start with emoji
• Include specificity (numbers/dates)
• Latin American Spanish (neutral)
• Mirror meaning and intent, not word-for-word translation

Formats:

• Informational: 📉 [Tema] [Dato] — [Relevancia/Contexto]
• Hook-driven: ¿[Pregunta]? — [Implicación]
• Punchy: [Tema] [Dato] — [Señal/Impacto]

Guidelines:

• Use natural Spanish phrasing that resonates with Hispanic audiences
• Adapt cultural references where appropriate
• Maintain urgency/emotion of the English version
• Consider that Spanish titles may need slight restructuring to fit character limit

Deliverable 11: HeyGen Production Brief

Auto-generated based on content tone analysis. See Step 3 for selection logic.

Deliverable 12: CTA Tracking Summary

**CTA Keyword:** [KEYWORD]
**English CTA (Script):** "[Full CTA sentence]"
**Spanish CTA (Script):** "[Full CTA sentence]"
**Tracking Note:** Use this keyword to track leads from this specific content piece.

---

Step 3: Auto-Match Look & Animation

Tone Detection Keywords

Tone	Trigger Keywords/Context
urgent	rates rising, deadline, act now, don't miss, limited time, market crash, warning
educational	how to, explained, here's why, the key is, understanding, guide, tip
celebratory	great news, milestone, achievement, congratulations, exciting, record low
conversational	did you know, let's talk, here's the thing, quick update, thinking about
authoritative	market analysis, forecast, data shows, according to, expert insight, report
relatable	real talk, honestly, between us, truth is, been there, struggle, hustle, grind

Look Selection Matrix

Tone	Primary Look Category	Default Look
urgent	Strictly Business	The Closer
educational	Business Casual	Coffee Shop Consult
celebratory	Relaxed Professional	Casual Friday
conversational	Business Casual	Co-Working Space
authoritative	Strictly Business	Market Analyst
relatable	UGC & Candid	Post-Gym Car Rant

Animation Selection Matrix

Tone	Animation Preset
urgent	Dynamic Announcement
educational	Expert Presentation
celebratory	Encouraging & Motivational
conversational	Thoughtful Conversation
authoritative	Authoritative Delivery
relatable	Casual Vlog Style

See references/sofia-library.md for complete look prompts and animation presets.

---

Sofia Look Library

Category 1: Strictly Business

For urgent and authoritative tones

The Closer: Professional Sofia in a tailored blazer, confident posture, clean office background with subtle luxury touches. Sharp lighting, neutral tones. 4K, executive presence, polished.

Market Analyst: Sofia at a standing desk with multiple monitors showing charts. Wearing a fitted button-down shirt. Modern office aesthetic, blue-tinted lighting from screens. 4K, data-driven atmosphere.

Category 2: Business Casual

For educational and conversational tones

Coffee Shop Consult: Professional yet approachable Sofia in a modern coffee shop or casual office setting. Soft natural lighting, warm neutral tones. Smart casual blazer over a simple top. Knowledgeable but relatable. 4K, lifestyle professional.

Co-Working Space: Sofia in a trendy co-working environment with exposed brick or modern furniture. Wearing a casual blazer or cardigan. Natural lighting, creative energy. 4K, startup aesthetic.

Category 3: Relaxed Professional

For celebratory tones

Casual Friday: Sofia in elevated casual wear—nice jeans and a quality blouse or sweater. Home office or living room setting. Warm, inviting lighting. 4K, approachable expert.

Category 4: UGC & Candid Collection

For relatable tones — Raw & Authentic

Post-Gym Car Rant: A selfie-style shot taken from inside a parked car. Sofia is in the driver's seat wearing a black athletic tank top and a seatbelt. She has a slight post-workout glow (sheen on skin), and her blonde hair is in a slightly messy, loose bun with some flyaways. The lighting is slightly harsh sunlight coming from the side window, creating realistic shadows. 4K, shot on iPhone style, ultra-realistic skin texture, depth of field showing a parking lot background.

The "Walk & Talk" Update: A dynamic selfie shot of Sofia walking down a busy sidewalk. The camera angle is slightly high (held by her extended arm). She is wearing a grey zip-up hoodie over a white tee. Her hair is windblown across one side of her face. The background is a bit blurry (motion blur) showing city traffic. The lighting is overcast and flat, very natural. 4K, GoPro aesthetic, candid moment, high realism.

Late Night Grind: A low-light, slightly grainy selfie taken in a home office. The only light source is the blue glow of a laptop screen reflecting on Sofia's face. She is wearing oversized reading glasses and a comfortable, baggy university sweatshirt. Her hair is down and tousled. She looks tired but smiles faintly at the camera. 4K, webcam aesthetic, low light noise, ultra-realistic.

Morning Coffee (No Makeup Look): Sofia standing in a kitchen with "morning light" blowing out the background slightly (overexposed window). She is wearing a simple, wrinkled oversized grey t-shirt. She is holding a large ceramic mug with both hands close to her face. Her hair is messy/bedhead style. Her makeup looks very minimal/natural. 4K, candid lifestyle photography, soft focus, highly detailed.

The "Just Between Us" Hallway: A vertical selfie shot of Sofia standing in a dimly lit hallway with yellow-toned overhead lighting (imperfect indoor lighting). She is wearing a casual denim button-down shirt with sleeves rolled up. She is whispering/leaning into the camera lens. The background is a plain beige wall with a shadow cast behind her. 4K, shot on smartphone, raw file look, realistic textures.

Errands Run: A selfie taken in a grocery store aisle or a hardware store (Home Depot style). Sofia is wearing a baseball cap (backwards or forwards) and a simple black long-sleeve tee. Shelves are visible in the background. The lighting is fluorescent and slightly unflattering (greenish tint) to sell the realism. She looks busy. 4K, everyday life, ultra-detailed, sharp focus on eyes.

Rainy Day Car Wait: Inside a car while it is raining. Raindrops are on the window, blurring the outside world. Sofia is wearing a rain jacket or trench coat. The lighting is grey and moody. The angle is a bit lower, looking up at her as if the phone is resting on the steering wheel. Her hair is slightly damp/frizzy from the humidity. 4K, atmospheric, moody lighting, photorealistic.

Messy Desk/Brainstorming: A high-angle selfie (as if she is holding the phone up high looking down). Sofia is sitting on the floor or a beanbag with papers scattered around her. She is wearing sweatpants and a tight tank top. She has a pen behind her ear. The room is not perfectly tidy. 4K, fish-eye lens effect, casual vibe, ultra-realistic.

Sun Glare/Outdoor Walk: Sofia is outside, but the sun is directly behind her, creating a lens flare that washes out part of the image (intentional imperfection). She is squinting slightly and smiling, wearing a simple fleece vest. The image looks like a spontaneous snapshot taken during a hike or property walk-through. 4K, bright sunlight, lens flare, natural skin texture.

The Mirror Selfie: Sofia standing in front of a full-length mirror in a bedroom or closet. The phone covers part of her face or is held to the side. She is trying on a blazer over a casual outfit (jeans and tee), asking for an opinion. The room background shows a bit of clutter (clothes on a bed) to make it feel lived-in. 4K, mirror reflection, indoor lighting, authentic lifestyle.

---

UGC Look Selection Guide

Use UGC looks when content benefits from authenticity over polish:

UGC Look	Best For
Post-Gym Car Rant	Hot takes, market frustrations, "here's what nobody's telling you"
Walk & Talk	Quick tips, on-the-go updates, breaking news reactions
Late Night Grind	Behind-the-scenes, "working on something," relatable hustle content
Morning Coffee	Gentle advice, soft sells, "let's chat" intimate topics
Just Between Us	Insider tips, "secrets," confidential-feeling advice
Errands Run	Everyday money tips, quick hacks, "while I was at the store" content
Rainy Day Car Wait	Reflective content, patience themes, "waiting for the market"
Messy Desk/Brainstorming	Creative process, planning content, "working on your loan"
Sun Glare/Outdoor Walk	Property content, neighborhood tours, optimistic market takes
Mirror Selfie	Casual Q&A, "getting ready for your meeting," approachable advice

---

Output Template

## 📝 DELIVERABLES

### 0. CTA Keyword Assignment
**CTA Keyword:** [KEYWORD]
**Rationale:** [Why this keyword fits the content]

---

### 1. English Script (HeyGen - Sofia)
Hi, I'm Sofia. [Script with CTA]

**Word count:** X words | **Duration:** ~Xs

---

### 2. Spanish Script (HeyGen - Sofía)
Hola, soy Sofía. [Script with CTA]

**Conteo de palabras:** X palabras | **Duración:** ~Xs

---

### 3. English Video Description (Facebook/Instagram/TikTok/YouTube)
[Complete description with keyword CTAs]

---

### 4. Spanish Video Description (Facebook/Instagram/TikTok/YouTube)
[Complete description with keyword CTAs]

---

### 5. Threads Description — English (≤500 chars)
[Condensed description with keyword CTA]

**Character count:** X/500

---

### 6. Threads Description — Spanish (≤500 chars)
[Condensed description with keyword CTA]

**Conteo de caracteres:** X/500

---

### 7. Bluesky Description — English (≤300 chars)
[Ultra-concise description with keyword CTA]

**Character count:** X/300

---

### 8. Bluesky Description — Spanish (≤300 chars)
[Ultra-concise description with keyword CTA]

**Conteo de caracteres:** X/300

---

### 9. English YouTube Shorts Title Options
**Primary:** [Title]
**Alternative 1:** [Title]
**Alternative 2:** [Title]

---

### 10. Spanish YouTube Shorts Title Options / Títulos en Español
**Principal:** [Título]
**Alternativa 1:** [Título]
**Alternativa 2:** [Título]

---

### 11. HeyGen Production Brief

**Detected Tone:** [tone]

**Recommended Look:**
- Category: [Strictly Business / Business Casual / Relaxed Professional / UGC & Candid]
- Name: "[Look Name]"
- Prompt: [Full image prompt from library]

**Recommended Animation:**
- Style: [Animation Name]
- Prompt: [Full animation prompt]

**Custom Adjustments:** [Any modifications based on specific content needs]

**Alternative Options:**
- Look: "[Alternative]" if [condition]
- Animation: "[Alternative]" if [condition]

---

### 12. CTA Tracking Summary

**CTA Keyword:** [KEYWORD]
**English CTA (Script):** "[Full CTA sentence]"
**Spanish CTA (Script):** "[Full CTA sentence]"
**Tracking Note:** Use this keyword to track leads from this specific content piece.

---

Timing Validation

Language	Max Words (20s)	WPM Rate
English	50-54	160
Spanish	46-50	145

Formula: Words ÷ WPM × 60 ≤ 19 seconds

---

Quality Checklist

CTA Keyword:

• Maximum 5 characters
• ALL CAPS
• Relevant to content topic
• Unique/trackable

Scripts:

• Avatar intro present
• Under word limit
• Numbers written for speech
• Natural tone matches detected content tone
• Clear CTA with keyword at end

Full Descriptions (Facebook/Instagram/TikTok/YouTube):

• Hook creates curiosity
• 3 CTAs with keyword (DM, Call, Comment)
• 8-12 hashtags

Threads Descriptions:

• Under 500 characters (English)
• Under 500 characters (Spanish)
• Hook + insight + DM keyword CTA
• 3-4 hashtags maximum

Bluesky Descriptions:

• Under 300 characters (English)
• Under 300 characters (Spanish)
• No hashtags
• Brief DM keyword CTA
• Punchy and shareable

YouTube Titles (English):

• Under 100 characters
• Starts with emoji

YouTube Titles (Spanish):

• Under 100 characters
• Starts with emoji
• Natural Latin American Spanish phrasing

Production Brief:

• Tone correctly detected
• Look matches tone
• Animation matches tone
• Full prompts included (not just names)

CTA Tracking Summary:

• Keyword documented
• Both language CTAs recorded
• Ready for lead tracking