This skill should be used when transforming AI conversation outputs, research summaries, or raw content into production-ready social media packages for HeyGen avatar videos featuring Sofia. Use this skill for generating bilingual scripts (English/Spanish) under 20 seconds with trackable DM keywords, creating platform-specific video descriptions (Threads 500 chars, Bluesky 300 chars, Facebook/Instagram/TikTok/YouTube), producing optimized bilingual YouTube titles under 100 characters, converting LLM session outputs into video content, generating cross-platform social media copy with translations, or matching HeyGen looks and animations based on content tone.
From content-studionpx claudepluginhub nbkm8y5/claude-plugins --plugin content-studioThis skill uses the workspace's default tool permissions.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Executes pre-written implementation plans: critically reviews, follows bite-sized steps exactly, runs verifications, tracks progress with checkpoints, uses git worktrees, stops on blockers.
Guides idea refinement into designs: explores context, asks questions one-by-one, proposes approaches, presents sections for approval, writes/review specs before coding.
After generating content, validate and format output:
python3 ${CLAUDE_PLUGIN_ROOT}/lib/format_social_json.py < output.txt > output.json
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.
Extract from input:
urgent, educational, celebratory, conversational, authoritative, relatableEvery content package includes a trackable DM keyword that viewers use to engage. This enables lead tracking and personalized follow-up.
| 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 |
For Scripts (spoken):
For Descriptions (written):
Before generating any content, assign the keyword:
**CTA Keyword:** [KEYWORD]
**Rationale:** [Why this keyword fits the content]
Structure:
Hi, I'm Sofia. [Hook - 1 sentence]
[Core insight - 1-2 sentences with key data]
[CTA with keyword - 1 sentence]
Guidelines:
CTA Examples for Scripts:
Structure:
Hola, soy Sofía. [Gancho - 1 oración]
[Información clave - 1-2 oraciones]
[CTA con palabra clave - 1 oración]
Guidelines:
CTA Examples for Scripts:
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
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
Format:
[Emoji] [Strong hook - 1 sentence]
[Core insight condensed - 1-2 sentences]
📲 DM "[KEYWORD]" to learn more
[3-4 hashtags]
Guidelines:
Same structure as English Threads, culturally adapted:
Format:
[Emoji] [Punchy hook] [Core fact/insight] DM "[KEYWORD]" to learn more.
Guidelines:
Same structure as English Bluesky:
Formats:
📉 [Topic] [Data] — [Timeframe/Relevance][Question] — Is [Outcome] Coming?[Topic] [Data] — [Signal/Implication]Formats:
📉 [Tema] [Dato] — [Relevancia/Contexto]¿[Pregunta]? — [Implicación][Tema] [Dato] — [Señal/Impacto]Guidelines:
Auto-generated based on content tone analysis. See Step 3 for selection logic.
**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.
| 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 |
| 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 |
| 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.
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.
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.
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.
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.
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 |
## 📝 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.
| Language | Max Words (20s) | WPM Rate |
|---|---|---|
| English | 50-54 | 160 |
| Spanish | 46-50 | 145 |
Formula: Words ÷ WPM × 60 ≤ 19 seconds
CTA Keyword:
Scripts:
Full Descriptions (Facebook/Instagram/TikTok/YouTube):
Threads Descriptions:
Bluesky Descriptions:
YouTube Titles (English):
YouTube Titles (Spanish):
Production Brief:
CTA Tracking Summary: