From 5643d02eb2db99bc6be7b4bc7a414189b3b9f3ab Mon Sep 17 00:00:00 2001 From: marcusquinn <6428977+marcusquinn@users.noreply.github.com> Date: Tue, 10 Feb 2026 02:21:18 +0000 Subject: [PATCH] feat(content): add distribution channel reference agents (t199.8) Create content/distribution/ directory with 6 distribution channel agents that complete the content pipeline's multi-channel fan-out: - youtube/README.md: Reference agent pointing to root youtube/ subagents - short-form.md: TikTok, Reels, Shorts (existed, fixed MD lint errors) - social.md: X, LinkedIn, Reddit with platform-native tone adaptation - blog.md: SEO-optimized articles integrating legacy content tools - email.md: Newsletters, sequences, FluentCRM integration - podcast.md: Audio-first distribution, show notes, syndication All agents follow the established pattern (YAML frontmatter, AI-CONTEXT markers, cross-references to pipeline stages and related tools). Zero markdownlint errors across all 6 files. --- .agents/content/distribution/blog.md | 253 +++++++ .agents/content/distribution/email.md | 264 +++++++ .agents/content/distribution/podcast.md | 333 ++++++++ .agents/content/distribution/short-form.md | 713 ++++++++++++++++++ .agents/content/distribution/social.md | 295 ++++++++ .../content/distribution/youtube/README.md | 79 ++ 6 files changed, 1937 insertions(+) create mode 100644 .agents/content/distribution/blog.md create mode 100644 .agents/content/distribution/email.md create mode 100644 .agents/content/distribution/podcast.md create mode 100644 .agents/content/distribution/short-form.md create mode 100644 .agents/content/distribution/social.md create mode 100644 .agents/content/distribution/youtube/README.md diff --git a/.agents/content/distribution/blog.md b/.agents/content/distribution/blog.md new file mode 100644 index 0000000000..4f3325ccb7 --- /dev/null +++ b/.agents/content/distribution/blog.md @@ -0,0 +1,253 @@ +--- +name: blog +description: Blog distribution - SEO-optimized articles from content pipeline assets +mode: subagent +model: sonnet +--- + +# Blog - SEO-Optimized Article Distribution + + + +## Quick Reference + +- **Purpose**: Transform content pipeline assets into SEO-optimized blog articles +- **Format**: Long-form articles (1,500-3,000 words), pillar content, supporting posts +- **Key Principle**: Research-backed, keyword-targeted, human-readable content +- **Success Metrics**: Organic traffic, time on page, scroll depth, conversions + +**Critical Rules**: + +- **Keyword-first** - Every article targets a primary keyword with validated search volume +- **Human voice** - AI-generated content must pass through `content/humanise.md` and `content/editor.md` +- **Internal linking** - 3-5 internal links per article using `content/internal-linker.md` +- **Meta optimization** - Title tag, meta description, and OG tags via `content/meta-creator.md` +- **One sentence per paragraph** - Per `content/guidelines.md` standards + +**Legacy Content Tools** (integrated into this workflow): + +- `content/seo-writer.md` - SEO-optimized writing +- `content/editor.md` - Human voice transformation +- `content/humanise.md` - Remove AI writing patterns +- `content/meta-creator.md` - Meta titles and descriptions +- `content/internal-linker.md` - Strategic internal linking +- `content/context-templates.md` - Per-project SEO context + + + +## Article Types + +### Pillar Content (2,000-3,000 words) + +Comprehensive guides that target high-volume keywords and serve as link hubs. + +**Structure**: + +1. **Title** - Keyword-front, under 60 characters, value hook +2. **Meta description** - 150-160 characters, includes keyword, compelling CTA +3. **Introduction** (100-150 words) - Hook, problem statement, what the reader will learn +4. **Table of contents** - Jump links for articles over 1,500 words +5. **Body sections** (H2/H3 hierarchy) - One topic per section, scannable +6. **Key takeaways** - Bulleted summary of main points +7. **CTA** - Newsletter signup, related content, or product link +8. **FAQ section** - Target featured snippet opportunities + +**Example**: + +```text +Story: "Why 95% of AI influencers fail" + +Pillar Article: +Title: Why 95% of AI Influencers Fail (And How to Be in the 5%) +H2: The AI Content Gold Rush +H2: 5 Mistakes That Kill AI Influencer Careers + H3: Mistake 1 - Chasing Tools Instead of Problems + H3: Mistake 2 - Publishing Unedited AI Content + H3: Mistake 3 - Ignoring Audience Research + H3: Mistake 4 - No Testing or Optimization + H3: Mistake 5 - One-Off Posts Instead of Systems +H2: What the Top 5% Do Differently +H2: Building Your AI Content System +H2: Key Takeaways +H2: FAQ +``` + +### Supporting Posts (800-1,500 words) + +Focused articles that target long-tail keywords and link back to pillar content. + +**Structure**: + +1. **Title** - Long-tail keyword, specific angle +2. **Introduction** (50-100 words) - Quick hook, what the reader will learn +3. **Body** (3-5 H2 sections) - Focused, actionable content +4. **Internal link** to pillar content +5. **CTA** - Related content or conversion action + +### Listicles (1,000-2,000 words) + +Numbered lists that target "best", "top", and "how to" keywords. + +**Structure**: + +1. **Title** - Number + keyword + year (e.g., "7 Best AI Video Tools in 2026") +2. **Introduction** - Selection criteria, what makes the list +3. **Numbered items** - Each with H2, description, pros/cons, use case +4. **Comparison table** - Quick-reference summary +5. **Verdict** - Recommendation based on use case + +## SEO Workflow + +### 1. Keyword Research + +**From `seo/keyword-research.md` and `seo/dataforseo.md`**: + +```bash +# Research keywords for a topic +keyword-research-helper.sh volume "AI video generation tools" +keyword-research-helper.sh related "AI video generation" +keyword-research-helper.sh difficulty "AI video generation tools" +``` + +**Keyword Selection Criteria**: + +| Factor | Target | +|--------|--------| +| **Monthly volume** | 500+ for pillar, 100+ for supporting | +| **Keyword difficulty** | Under 40 for new sites, under 60 for established | +| **Search intent** | Informational or commercial investigation | +| **SERP features** | Featured snippet opportunity = priority | + +### 2. Content Brief + +Before writing, create a brief: + +- **Primary keyword** and 3-5 secondary keywords +- **Search intent** (informational, commercial, transactional) +- **Target word count** based on SERP analysis +- **Competitor analysis** - Top 5 ranking articles, their structure and gaps +- **Unique angle** - What will this article offer that competitors don't? +- **Internal links** - Which existing articles to link to/from + +### 3. Writing + +**Pipeline integration**: + +1. **Story** from `content/story.md` provides narrative framework +2. **Research** from `content/research.md` provides data and insights +3. **SEO writer** (`content/seo-writer.md`) drafts keyword-optimized content +4. **Editor** (`content/editor.md`) transforms to human voice +5. **Humanise** (`content/humanise.md`) removes AI patterns +6. **Meta creator** (`content/meta-creator.md`) generates title tag and meta description +7. **Internal linker** (`content/internal-linker.md`) adds strategic internal links + +### 4. On-Page Optimization + +**Checklist**: + +- [ ] Primary keyword in title tag (first 60 chars) +- [ ] Primary keyword in H1 +- [ ] Primary keyword in first 100 words +- [ ] Primary keyword in meta description +- [ ] Secondary keywords in H2 headings +- [ ] Alt text on all images (include keyword where natural) +- [ ] Internal links (3-5 per article) +- [ ] External links to authoritative sources (2-3 per article) +- [ ] URL slug contains primary keyword +- [ ] Schema markup (Article, FAQ, HowTo as applicable) + +### 5. Content Analysis + +```bash +# Full content analysis +python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py analyze article.md --keyword "target keyword" + +# Individual checks +python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py readability article.md +python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py keywords article.md --keyword "keyword" +python3 ~/.aidevops/agents/scripts/seo-content-analyzer.py quality article.md +``` + +## Content from Pipeline Assets + +### From YouTube Video + +1. **Extract transcript** using `youtube-helper.sh transcript VIDEO_ID` +2. **Restructure** for reading (video scripts are conversational, articles are structured) +3. **Add SEO elements** - keyword optimization, meta tags, internal links +4. **Expand** with additional research, examples, and data +5. **Add visuals** - Screenshots, diagrams, embedded video + +### From Research Phase + +1. **Use research brief** as article foundation +2. **Structure** around key findings +3. **Add original analysis** and expert perspective +4. **Include data** - Stats, charts, comparisons +5. **Link to sources** for credibility + +### From Short-Form Content + +1. **Expand** a high-performing short into a full article +2. **Add depth** - Context, examples, methodology +3. **Target related long-tail keywords** +4. **Embed** the original short-form video + +## Publishing Workflow + +### WordPress Integration + +**From `tools/wordpress/wp-dev.md`**: + +- Draft creation via WP REST API or WP-CLI +- Category and tag assignment +- Featured image upload +- Yoast/RankMath SEO fields +- Scheduled publishing + +### Content Calendar + +**From `content/optimization.md`**: + +- **Pillar content**: 1-2 per month +- **Supporting posts**: 2-4 per week +- **Listicles**: 1-2 per month +- **Updates**: Refresh top-performing articles quarterly + +### Post-Publish Checklist + +- [ ] Verify indexing (Google Search Console) +- [ ] Share on social channels (`content/distribution/social.md`) +- [ ] Include in next newsletter (`content/distribution/email.md`) +- [ ] Internal link from 2-3 existing articles +- [ ] Monitor rankings for target keyword (weekly for first month) + +## Related Agents and Tools + +**Content Pipeline**: + +- `content/research.md` - Audience research and niche validation +- `content/story.md` - Hook formulas and narrative design +- `content/guidelines.md` - Content standards and style guide +- `content/optimization.md` - A/B testing and analytics loops + +**SEO**: + +- `seo.md` - SEO orchestrator +- `seo/keyword-research.md` - Keyword volume and difficulty +- `seo/dataforseo.md` - SERP data and competitor analysis +- `seo/google-search-console.md` - Performance monitoring +- `seo/content-analyzer.md` - Content quality scoring + +**Distribution Channels**: + +- `content/distribution/youtube/` - Long-form YouTube content +- `content/distribution/short-form.md` - TikTok, Reels, Shorts +- `content/distribution/social.md` - X, LinkedIn, Reddit +- `content/distribution/email.md` - Newsletters and sequences +- `content/distribution/podcast.md` - Audio-first distribution + +**WordPress**: + +- `tools/wordpress/wp-dev.md` - WordPress development and API +- `tools/wordpress/mainwp.md` - Multi-site management diff --git a/.agents/content/distribution/email.md b/.agents/content/distribution/email.md new file mode 100644 index 0000000000..8e619b66dd --- /dev/null +++ b/.agents/content/distribution/email.md @@ -0,0 +1,264 @@ +--- +name: email +description: Email distribution - newsletters, sequences, and automated campaigns +mode: subagent +model: sonnet +--- + +# Email - Newsletter and Sequence Distribution + + + +## Quick Reference + +- **Purpose**: Distribute content via email newsletters, automated sequences, and campaigns +- **Formats**: Weekly newsletter, welcome sequence, launch sequence, nurture sequence +- **Key Principle**: Permission-based, value-first, relationship-building +- **Success Metrics**: Open rate, click rate, reply rate, unsubscribe rate +- **CRM Integration**: FluentCRM via `marketing.md` and `services/crm/fluentcrm.md` + +**Critical Rules**: + +- **Subject line is the hook** - 80% of email success is the subject line +- **One CTA per email** - Multiple CTAs reduce click-through rate +- **Mobile-first** - 60%+ of emails opened on mobile +- **Value before ask** - Minimum 3:1 value-to-promotion ratio +- **Segment aggressively** - Personalized emails outperform broadcasts 6x + + + +## Email Types + +### Weekly Newsletter + +**Purpose**: Consistent touchpoint that builds trust and keeps audience engaged. + +**Structure**: + +1. **Subject line** - Curiosity hook or specific value promise (under 50 chars) +2. **Preview text** - Extends the hook (under 90 chars) +3. **Personal opener** (2-3 sentences) - Story, observation, or lesson +4. **Main content** (200-400 words) - One key insight or framework +5. **Content roundup** (3-5 links) - Best content from the week +6. **CTA** - One clear action (reply, click, share) +7. **PS line** - Secondary offer or personal note (highest-read section after subject) + +**Cadence**: Weekly, same day and time (consistency builds habit). + +**Content Adaptation from Pipeline**: + +```text +Story: "Why 95% of AI influencers fail" + +Newsletter: +Subject: The 5 mistakes killing AI influencers +Preview: I studied 50 creators for 6 months. Here's what I found. + +Hey [Name], + +I spent the last 6 months studying 50 AI content creators. + +The pattern was brutal: 95% of them are making the same 5 mistakes. + +Here's the one that surprised me most: + +They chase tools instead of problems. + +Nobody cares about your Sora 2 demo. They care about making +better videos faster. + +The creators who are actually growing? They research their +audience obsessively, edit AI output ruthlessly, and test +10 variants before committing. + +I broke down all 5 mistakes (and what the top 5% do instead) +in this week's video: [link] + +What's your biggest challenge with AI content? +Hit reply - I read every response. + +[Name] + +PS - I'm putting together a free guide on building an AI content +system. Reply "GUIDE" if you want early access. +``` + +### Welcome Sequence (5-7 emails) + +**Purpose**: Onboard new subscribers, establish value, and segment by interest. + +**Sequence**: + +| Email | Timing | Purpose | Content | +|-------|--------|---------|---------| +| **1** | Immediate | Deliver lead magnet + set expectations | Welcome, download link, what to expect | +| **2** | Day 1 | Quick win | One actionable tip they can use today | +| **3** | Day 3 | Story + credibility | Your journey, results, why you're qualified | +| **4** | Day 5 | Deep value | Best framework or methodology | +| **5** | Day 7 | Social proof | Case study or testimonial | +| **6** | Day 10 | Soft pitch | Introduce paid offering with value framing | +| **7** | Day 14 | Direct pitch | Clear CTA with urgency or bonus | + +**Key Principles**: + +- Each email should stand alone (not everyone reads sequentially) +- Build trust before asking for anything +- Segment based on clicks (interested in topic A vs topic B) +- Remove non-openers after email 3 (clean list) + +### Launch Sequence (5-7 emails) + +**Purpose**: Drive sales for a product launch or promotion. + +**Sequence**: + +| Email | Timing | Purpose | Content | +|-------|--------|---------|---------| +| **1** | Day -3 | Anticipation | Problem awareness, hint at solution | +| **2** | Day -1 | Story | Your journey solving this problem | +| **3** | Day 0 | Launch | Product reveal, benefits, early-bird offer | +| **4** | Day 1 | Social proof | Testimonials, case studies, results | +| **5** | Day 3 | FAQ | Objection handling, common questions | +| **6** | Day 5 | Scarcity | Deadline reminder, bonus expiring | +| **7** | Day 7 | Last chance | Final call, urgency, FOMO | + +### Nurture Sequence + +**Purpose**: Long-term relationship building for subscribers who didn't convert. + +**Cadence**: Weekly or bi-weekly. + +**Content Mix**: + +- 60% educational (tips, frameworks, insights) +- 20% story-driven (personal experiences, case studies) +- 10% curated (best resources, tools, articles) +- 10% promotional (soft pitches, offers) + +## Subject Line Formulas + +### High-Performing Patterns + +| Formula | Example | Why It Works | +|---------|---------|-------------| +| **Number + benefit** | "5 AI tools that save 10 hours/week" | Specific, scannable | +| **Question** | "Are you making this AI content mistake?" | Curiosity gap | +| **How-to** | "How to create 10 videos per day with AI" | Clear value | +| **Contrarian** | "Stop using ChatGPT for content" | Pattern interrupt | +| **Personal** | "I wasted $5k on AI tools (so you don't have to)" | Authenticity | +| **Urgency** | "Last chance: AI content guide (free until Friday)" | Scarcity | +| **Curiosity** | "The AI video secret nobody talks about" | Open loop | +| **Social proof** | "How [Name] went from 0 to 100k with AI content" | Aspirational | + +### Subject Line Rules + +- Under 50 characters (mobile truncation) +- No ALL CAPS (spam filter trigger) +- No excessive punctuation (!!!, ???) +- Personalization token when available ([Name]) +- A/B test 2-3 variants per send +- Preview text extends the hook (not repeats it) + +## Email Design + +### Mobile-First Layout + +- **Width**: 600px maximum +- **Font size**: 16px minimum body, 22px+ headings +- **CTA button**: 44px minimum height, high contrast +- **Images**: Optional, not required for message +- **Single column**: No multi-column layouts on mobile + +### Plain Text vs HTML + +| Format | Best For | Open Rate Impact | +|--------|----------|-----------------| +| **Plain text** | Personal newsletters, B2B | Higher (feels personal) | +| **Light HTML** | Branded newsletters, B2C | Moderate (professional) | +| **Heavy HTML** | E-commerce, promotions | Lower (feels promotional) | + +**Recommendation**: Plain text or light HTML for content-focused newsletters. Heavy HTML only for product launches and promotions. + +## Segmentation Strategy + +### Segment by Behavior + +| Segment | Criteria | Content Strategy | +|---------|----------|-----------------| +| **Engaged** | Opened 3+ of last 5 emails | Full content, early access, premium offers | +| **Casual** | Opened 1-2 of last 5 emails | Re-engagement, best-of content, surveys | +| **Cold** | No opens in 30+ days | Win-back sequence, then remove | +| **Buyers** | Purchased any product | Upsell, loyalty, exclusive content | +| **Clickers** | Clicked specific topic links | Topic-specific content and offers | + +### Segment by Interest + +Tag subscribers based on: + +- Lead magnet downloaded (topic interest) +- Links clicked in newsletters (content preference) +- Survey responses (self-reported interests) +- Purchase history (product category) + +## FluentCRM Integration + +**From `marketing.md` and `services/crm/fluentcrm.md`**: + +```bash +# Create a new email campaign +# Use FluentCRM MCP tools for: +# - Contact management and segmentation +# - Email sequence creation +# - Automation triggers +# - Performance analytics +``` + +**Automation Triggers**: + +- New subscriber → Welcome sequence +- Link click → Tag + segment +- Purchase → Buyer sequence +- No open in 30 days → Win-back sequence +- Unsubscribe → Exit survey + +## Analytics and Optimization + +### Key Metrics + +| Metric | Target | Action if Below | +|--------|--------|----------------| +| **Open rate** | 30%+ | Improve subject lines, clean list | +| **Click rate** | 3%+ | Improve CTA, content relevance | +| **Reply rate** | 1%+ | More personal tone, ask questions | +| **Unsubscribe rate** | Under 0.5% | Check frequency, content quality | +| **Spam complaint rate** | Under 0.1% | Review opt-in process, add unsubscribe | + +### A/B Testing (from `content/optimization.md`) + +- **Subject lines**: Test 2-3 variants per send +- **Send time**: Test different days and times over 4 weeks +- **CTA placement**: Above fold vs end of email +- **Content length**: Short (100 words) vs long (400 words) +- **250-subscriber minimum** per variant before judging + +## Related Agents and Tools + +**Content Pipeline**: + +- `content/research.md` - Audience research and niche validation +- `content/story.md` - Hook formulas and narrative design +- `content/guidelines.md` - Content standards and style guide +- `content/optimization.md` - A/B testing and analytics loops + +**CRM and Marketing**: + +- `marketing.md` - Marketing orchestrator with FluentCRM integration +- `services/crm/fluentcrm.md` - CRM operations and automation + +**Distribution Channels**: + +- `content/distribution/youtube/` - Long-form YouTube content +- `content/distribution/short-form.md` - TikTok, Reels, Shorts +- `content/distribution/social.md` - X, LinkedIn, Reddit +- `content/distribution/blog.md` - SEO-optimized articles +- `content/distribution/podcast.md` - Audio-first distribution diff --git a/.agents/content/distribution/podcast.md b/.agents/content/distribution/podcast.md new file mode 100644 index 0000000000..2cab2142a2 --- /dev/null +++ b/.agents/content/distribution/podcast.md @@ -0,0 +1,333 @@ +--- +name: podcast +description: Podcast distribution - audio-first content, show notes, and syndication +mode: subagent +model: sonnet +--- + +# Podcast - Audio-First Distribution + + + +## Quick Reference + +- **Purpose**: Distribute content as podcast episodes with show notes and syndication +- **Formats**: Solo episodes, interviews, repurposed video audio, mini-episodes +- **Key Principle**: Audio-first design - content must work without visuals +- **Success Metrics**: Downloads, listen-through rate, subscriber growth, reviews + +**Critical Rules**: + +- **Audio quality is non-negotiable** - Bad audio = instant skip (use voice pipeline) +- **Hook in first 30 seconds** - State the value proposition immediately +- **Show notes are SEO content** - Treat them as blog posts with timestamps +- **Consistency beats quality** - Regular schedule matters more than production value +- **Repurpose everything** - Every podcast episode feeds 5+ other channels + +**Voice Pipeline** (from `content/production/audio.md`): + +1. CapCut AI voice cleanup (normalize accents, remove artifacts) +2. ElevenLabs transformation (voice cloning or style transfer) +3. NEVER publish raw AI audio - always process through the pipeline + + + +## Episode Types + +### Solo Episode (15-30 minutes) + +**Purpose**: Share expertise, frameworks, and insights directly. + +**Structure**: + +1. **Cold open** (0-30s) - Hook with the episode's key insight or bold claim +2. **Intro** (30s-1m) - Show name, episode number, what the listener will learn +3. **Context** (1-3m) - Why this topic matters now, who it's for +4. **Body** (10-20m) - 3-5 main points with examples and stories +5. **Summary** (1-2m) - Key takeaways in bullet form +6. **CTA** (30s) - Subscribe, review, visit link, join community + +**Content Adaptation from Pipeline**: + +```text +Story: "Why 95% of AI influencers fail" + +Solo Episode Outline: +[0:00] "95% of AI influencers will fail this year. I spent 6 months + studying why. Here are the 5 mistakes they're all making." + +[0:30] "Welcome to [Show Name], episode [X]. I'm [Name], and today + we're breaking down what separates the 5% who succeed in AI + content from the 95% who don't." + +[1:00] Context: The AI content gold rush, why everyone's jumping in, + and why most will fail. + +[3:00] Mistake 1: Chasing tools instead of problems + - Example: Sora 2 demos vs solving video production pain + - What the top creators do instead + +[8:00] Mistake 2: Publishing unedited AI content + - Why audiences can always tell + - The editing workflow that works + +[13:00] Mistake 3: Ignoring audience research + - The 30-Minute Expert Method + - Reddit as a goldmine for audience insights + +[18:00] Mistake 4: No testing or optimization + - The 10-variant rule + - A/B testing discipline + +[22:00] Mistake 5: One-off posts instead of systems + - The multi-media multiplier + - Building repeatable content systems + +[26:00] Summary: "If you take one thing from this episode..." + +[27:00] CTA: "Subscribe, leave a review, and check the show notes + for the full framework breakdown." +``` + +### Interview Episode (30-60 minutes) + +**Structure**: + +1. **Cold open** (0-30s) - Best quote or insight from the guest +2. **Intro** (30s-2m) - Guest introduction, why they're on the show +3. **Background** (2-5m) - Guest's story and credibility +4. **Core discussion** (20-40m) - 5-7 prepared questions with follow-ups +5. **Rapid fire** (3-5m) - Quick questions for personality and variety +6. **Guest CTA** (1m) - Where to find the guest +7. **Host CTA** (30s) - Subscribe, review, next episode preview + +**Interview Prep**: + +- Research guest's recent content, interviews, and social posts +- Prepare 7-10 questions (use 5-7, save rest for follow-ups) +- Identify 2-3 unique angles not covered in other interviews +- Send guest a brief with topic areas (not exact questions) + +### Repurposed Video Episode + +**Purpose**: Extract audio from YouTube videos for podcast distribution. + +**Workflow**: + +1. **Extract audio** from YouTube video using `yt-dlp-helper.sh` +2. **Process through voice pipeline** (`content/production/audio.md`) +3. **Add podcast intro/outro** (pre-recorded bumpers) +4. **Edit for audio-only** - Remove visual references ("as you can see...") +5. **Generate show notes** with timestamps +6. **Publish** to podcast platforms + +### Mini-Episode (5-10 minutes) + +**Purpose**: Quick tips, news commentary, or single-concept deep dives. + +**Structure**: + +1. **Hook** (0-15s) - One sentence value proposition +2. **Content** (3-8m) - Single topic, actionable advice +3. **CTA** (15-30s) - Quick subscribe reminder + +**Best For**: Daily or 3x/week publishing cadence, building consistency. + +## Show Notes + +### Show Notes as SEO Content + +Show notes are not just episode summaries - they're SEO-optimized blog posts that drive organic traffic to your podcast. + +**Structure**: + +1. **Title** - Episode number + keyword-optimized title +2. **Meta description** - 150-160 chars with primary keyword +3. **Summary** (100-150 words) - What the episode covers and who it's for +4. **Key takeaways** - 5-7 bullet points +5. **Timestamps** - Clickable chapter markers +6. **Transcript** (optional) - Full or partial, keyword-rich +7. **Resources mentioned** - Links to tools, articles, people +8. **CTA** - Subscribe links for all platforms + +**Example Show Notes**: + +```markdown +# Episode 47: Why 95% of AI Influencers Fail (And How to Be in the 5%) + +After studying 50 AI content creators for 6 months, I identified the +5 critical mistakes that separate the failures from the successes. + +## Key Takeaways + +- Chasing tools instead of solving audience problems is the #1 killer +- AI-generated content must be edited ruthlessly before publishing +- The 30-Minute Expert Method for audience research +- Test 10 variants before committing to any approach +- Build systems, not one-off viral attempts + +## Timestamps + +- 0:00 - Introduction +- 3:00 - Mistake 1: Chasing tools instead of problems +- 8:00 - Mistake 2: Publishing unedited AI content +- 13:00 - Mistake 3: Ignoring audience research +- 18:00 - Mistake 4: No testing or optimization +- 22:00 - Mistake 5: One-off posts instead of systems +- 26:00 - Summary and key takeaways + +## Resources Mentioned + +- [Sora 2 Pro](link) - AI video generation +- [The 30-Minute Expert Method](link) - Audience research framework +- [Content Optimization Guide](link) - A/B testing discipline + +## Subscribe + +- [Apple Podcasts](link) +- [Spotify](link) +- [YouTube](link) +- [RSS Feed](link) +``` + +## Audio Production + +### Recording Setup + +**Minimum Quality**: + +- USB condenser microphone (Audio-Technica AT2020 or similar) +- Quiet room with soft surfaces (reduce echo) +- Pop filter +- Headphones for monitoring + +**AI-Generated Audio** (from `content/production/audio.md`): + +1. **Script** from `content/production/writing.md` +2. **CapCut AI voice cleanup** - Normalize and clean +3. **ElevenLabs transformation** - Voice clone or style transfer +4. **Post-processing** - LUFS normalization, noise gate, compression + +### Audio Specifications + +| Parameter | Specification | +|-----------|--------------| +| **Format** | MP3 (192kbps) or AAC (128kbps) | +| **Sample rate** | 44.1kHz | +| **Channels** | Mono (solo), Stereo (interview/music) | +| **LUFS** | -16 LUFS (podcast standard) | +| **Bit depth** | 16-bit | +| **Silence** | 0.5s at start, 1s at end | + +### Post-Production Checklist + +- [ ] Noise reduction applied +- [ ] LUFS normalized to -16 +- [ ] Intro/outro bumpers added +- [ ] Chapter markers set +- [ ] ID3 tags filled (title, artist, album, episode number, artwork) +- [ ] Show notes written with timestamps +- [ ] Transcript generated (if applicable) + +## Distribution and Syndication + +### Podcast Hosting + +**Hosting Platform** (choose one): + +- **Buzzsprout** - Beginner-friendly, good analytics +- **Transistor** - Multiple shows, team features +- **Podbean** - Monetization built-in +- **Anchor/Spotify for Podcasters** - Free, Spotify-native + +### Platform Syndication + +Submit RSS feed to all major platforms: + +| Platform | Submission | Notes | +|----------|-----------|-------| +| **Apple Podcasts** | Podcasts Connect | 24-48h review | +| **Spotify** | Spotify for Podcasters | Near-instant | +| **Google Podcasts** | Google Podcasts Manager | Auto-indexed from RSS | +| **Amazon Music** | Amazon Music for Podcasters | 24-48h review | +| **Overcast** | Auto-indexed from Apple | No submission needed | +| **Pocket Casts** | Auto-indexed | No submission needed | +| **YouTube** | Upload as video or use RSS | Requires video or static image | + +### Publishing Cadence + +| Cadence | Best For | Effort Level | +|---------|----------|-------------| +| **Daily** (mini-episodes) | News, tips, building habit | High (batch record) | +| **3x/week** | Rapid growth, niche authority | Medium-high | +| **Weekly** | Sustainable, quality-focused | Medium | +| **Bi-weekly** | Side project, interview-heavy | Low-medium | + +## Cross-Channel Repurposing + +From one podcast episode, generate: + +| Output | Channel | How | +|--------|---------|-----| +| **Audiogram clips** (30-60s) | Short-form (`content/distribution/short-form.md`) | Extract best quotes, add waveform visual | +| **Blog post** | Blog (`content/distribution/blog.md`) | Expand show notes into full article | +| **Social quotes** | Social (`content/distribution/social.md`) | Key insights as X posts, LinkedIn quotes | +| **Newsletter feature** | Email (`content/distribution/email.md`) | Episode summary + key takeaway | +| **YouTube video** | YouTube (`content/distribution/youtube/`) | Record video version or add static image | +| **Transcript** | Blog/SEO | Full transcript as long-form SEO content | + +### Audiogram Production + +**For short-form distribution**: + +1. Extract 30-60s audio clip (best quote or insight) +2. Add waveform visualization or static image +3. Add captions (80%+ watch without sound on social) +4. Format 9:16 for TikTok/Reels/Shorts +5. Format 1:1 for X and LinkedIn + +## Analytics and Growth + +### Key Metrics + +| Metric | Target | Action if Below | +|--------|--------|----------------| +| **Downloads per episode** | Growing month-over-month | Improve titles, promote more | +| **Listen-through rate** | 60%+ | Improve content structure, tighter editing | +| **Subscriber growth** | 5%+ month-over-month | Cross-promote, guest appearances | +| **Reviews** | 4.5+ stars | Ask for reviews in CTA, improve quality | +| **Website traffic from show notes** | Growing | Improve SEO, add more links | + +### Growth Strategies + +1. **Guest appearances** on other podcasts (fastest growth lever) +2. **Cross-promotion** with complementary shows +3. **Audiogram clips** on social media +4. **SEO-optimized show notes** for organic discovery +5. **Email newsletter** featuring episodes +6. **YouTube** video versions for discoverability +7. **Community building** (Discord, Slack, or forum) + +## Related Agents and Tools + +**Content Pipeline**: + +- `content/research.md` - Audience research and niche validation +- `content/story.md` - Hook formulas and narrative design +- `content/production/audio.md` - Voice pipeline and audio production +- `content/production/writing.md` - Script writing +- `content/optimization.md` - A/B testing and analytics loops + +**Distribution Channels**: + +- `content/distribution/youtube/` - Long-form YouTube content +- `content/distribution/short-form.md` - TikTok, Reels, Shorts +- `content/distribution/social.md` - X, LinkedIn, Reddit +- `content/distribution/blog.md` - SEO-optimized articles +- `content/distribution/email.md` - Newsletters and sequences + +**Tools**: + +- `tools/voice/speech-to-speech.md` - Voice cloning and transformation +- `content/production/audio.md` - Audio production pipeline +- `youtube-helper.sh` - YouTube upload for video versions diff --git a/.agents/content/distribution/short-form.md b/.agents/content/distribution/short-form.md new file mode 100644 index 0000000000..24357e0482 --- /dev/null +++ b/.agents/content/distribution/short-form.md @@ -0,0 +1,713 @@ +--- +name: short-form +description: TikTok, Reels, and Shorts distribution - 9:16 vertical video optimization +mode: subagent +model: sonnet +--- + +# Short-Form - TikTok, Reels, and Shorts Distribution + + + +## Quick Reference + +- **Purpose**: Optimize content for TikTok, Instagram Reels, and YouTube Shorts +- **Format**: 9:16 vertical video, 15-90 seconds, hook-first structure +- **Key Platforms**: TikTok, Instagram Reels, YouTube Shorts, Snapchat Spotlight +- **Success Metrics**: Completion rate, shares, saves, watch time + +**Critical Rules**: + +- **Hook in first 1-3 seconds** - Pattern interrupt or immediate value +- **Fast cuts** - 1-3 second shots maximum +- **9:16 aspect ratio** - Vertical video only +- **60s sweet spot** - Optimal length for all platforms (15-90s range) +- **Trending sounds** - Platform-specific audio trends +- **Captions required** - 80%+ watch without sound +- **No watermarks** - Cross-posting penalties on all platforms + +**Platform-Specific Pacing**: + +| Platform | Optimal Length | Cut Speed | Sound Strategy | +|----------|---------------|-----------|----------------| +| TikTok | 15-60s | 1-2s cuts | Trending sounds critical | +| Reels | 30-60s | 2-3s cuts | Original audio + trending | +| Shorts | 30-60s | 2-3s cuts | Music library or original | +| Snapchat | 15-30s | 1-2s cuts | Original audio preferred | + +**Content Type Presets**: + +- **UGC-style** - 1-3s cuts, handheld feel, authentic voice +- **Educational** - 2-4s cuts, text overlays, clear narration +- **Entertainment** - 1-2s cuts, music-driven, visual hooks +- **Product showcase** - 2-3s cuts, benefit-focused, CTA at end + + + +## Hook-First Structure + +The first 1-3 seconds determine 80%+ of your completion rate. + +**7 Hook Formulas** (from `content/story.md`): + +1. **Bold Claim** - "This AI tool made me $10k in 3 days" +2. **Question** - "Why do 95% of AI influencers fail?" +3. **Story** - "I spent $5k on AI video tools. Here's what worked." +4. **Contrarian** - "Stop using ChatGPT for content creation" +5. **Result** - "From 0 to 100k followers in 30 days" +6. **Problem-Agitate** - "Your AI videos look fake. Here's why." +7. **Curiosity Gap** - "The AI video secret nobody talks about" + +**Visual Hook Patterns**: + +- **Extreme close-up** - Face, product, or detail shot +- **Unexpected action** - Pattern interrupt (drop, reveal, transformation) +- **Text overlay** - Bold statement in first frame +- **Before/After split** - Immediate contrast +- **POV shot** - First-person perspective + +## Script Structure + +**4-Part Framework** (adapted from `content/story.md`): + +### 1. Hook (1-3 seconds) + +- Visual + verbal pattern interrupt +- Text overlay with bold claim or question +- Immediate value promise + +**Example**: + +```text +[Visual: Extreme close-up of shocked face] +[Text: "I wasted $5k on AI tools"] +[Narration: "I spent five thousand dollars on AI video tools..."] +``` + +### 2. Storytelling (10-30 seconds) + +- Before/During/After transformation arc +- Problem → failed solutions → discovery +- Personal story or case study +- Fast cuts (1-3s per shot) + +**Example**: + +```text +[Cut 1: Screen recording of failed AI output] +"...and 95% of them produced garbage." + +[Cut 2: Montage of testing different tools] +"I tested 12 different platforms." + +[Cut 3: Reveal of working output] +"Until I found this one trick." +``` + +### 3. Soft Sell (5-15 seconds) + +- Solution reveal +- Benefit-focused (not feature-focused) +- Social proof or result +- Subtle CTA + +**Example**: + +```text +[Cut: Side-by-side before/after] +"Now I generate 10 videos per day that actually convert." + +[Cut: Analytics screenshot] +"And my engagement went up 300%." +``` + +### 4. CTA (1-3 seconds) + +- Follow for more +- Link in bio +- Comment keyword +- Save for later + +**Example**: + +```text +[Text overlay: "Follow for more AI tips"] +[Narration: "Follow for the full breakdown."] +``` + +## Platform-Specific Optimization + +### TikTok + +**Algorithm Priorities**: +- Completion rate (watch to end) +- Shares and saves +- Comments and engagement +- Watch time + +**Trending Sound Strategy**: +- Use trending sounds within 24-48h of peak +- Original sound for evergreen content +- Voiceover + trending background music + +**Hashtag Strategy**: +- 3-5 hashtags maximum +- Mix of trending + niche + branded +- Avoid banned or shadowbanned tags + +**Posting Cadence**: +- 1-3 posts per day +- Peak times: 6-9am, 12-3pm, 7-11pm (local time) +- Test different times for 7 days, analyze performance + +### Instagram Reels + +**Algorithm Priorities**: +- Shares to Stories and DMs +- Saves +- Completion rate +- Engagement (likes, comments) + +**Audio Strategy**: +- Original audio for reach (Instagram prioritizes original) +- Trending audio for discovery +- Voiceover + music mix + +**Hashtag Strategy**: +- 3-5 hashtags in caption or first comment +- Mix of broad + niche +- Avoid spammy or banned tags + +**Posting Cadence**: +- 1-2 Reels per day +- Peak times: 9-11am, 1-3pm, 7-9pm (local time) +- Cross-post to Feed for double reach + +### YouTube Shorts + +**Algorithm Priorities**: +- Watch time (total minutes watched) +- Click-through rate from Shorts feed +- Engagement (likes, comments, subscribes) +- Shares + +**Audio Strategy**: +- YouTube Audio Library for copyright-safe music +- Original audio for branding +- Voiceover clarity (Shorts viewers often have sound on) + +**Title and Description**: +- Front-load keywords in title +- Description with timestamps and links +- Hashtags: #Shorts + 2-3 topic tags + +**Posting Cadence**: +- 1-2 Shorts per day +- Peak times: 12-3pm, 6-9pm (local time) +- Link to long-form content in description + +### Snapchat Spotlight + +**Algorithm Priorities**: +- Unique content (no watermarks, no reposts) +- Completion rate +- Shares and screenshots +- Engagement + +**Audio Strategy**: +- Original audio strongly preferred +- No copyrighted music (strict enforcement) +- Voiceover or sound effects + +**Content Guidelines**: +- No logos or watermarks +- No clickbait or misleading content +- No political or controversial topics (limited reach) + +**Posting Cadence**: +- 1-2 Spotlights per day +- Peak times: 10am-12pm, 5-8pm (local time) + +## Production Workflow + +### 1. Script and Storyboard + +**From `content/production/writing.md`**: + +- Hook-first script (6-12 words for hook) +- Shot-by-shot breakdown (1-3s per shot) +- Dialogue pacing (8-second chunks for AI video) +- Text overlay cues +- Sound effect cues + +**Example Script**: + +```text +[0-2s] HOOK +Visual: Extreme close-up of shocked face +Text: "I wasted $5k on AI tools" +Narration: "I spent five thousand dollars on AI video tools..." + +[2-5s] PROBLEM +Visual: Screen recording of failed AI output +Text: "95% were garbage" +Narration: "...and 95% of them produced garbage." + +[5-10s] JOURNEY +Visual: Montage of testing different tools (3 x 1.5s cuts) +Text: "Tested 12 platforms" +Narration: "I tested 12 different platforms until I found this one trick." + +[10-15s] SOLUTION +Visual: Side-by-side before/after +Text: "10 videos/day now" +Narration: "Now I generate 10 videos per day that actually convert." + +[15-18s] RESULT +Visual: Analytics screenshot +Text: "+300% engagement" +Narration: "And my engagement went up 300%." + +[18-20s] CTA +Visual: Face to camera +Text: "Follow for more" +Narration: "Follow for the full breakdown." +``` + +### 2. Video Generation + +**From `content/production/video.md`**: + +**Sora 2 Pro** (UGC-style, authentic feel): +- 9:16 aspect ratio +- 1-3s cuts +- Handheld camera movement +- Natural lighting +- Seed range: 2000-3000 (YouTube-optimized) + +**Veo 3.1** (cinematic, high production value): +- 9:16 aspect ratio +- 2-5s cuts +- Smooth camera movements +- Professional lighting +- Ingredients-to-video workflow (upload face/product) + +**Content Type Presets**: +- **UGC**: 9:16, 1-3s cuts, handheld, natural light +- **Educational**: 9:16, 2-4s cuts, static or slow pan, clear lighting +- **Entertainment**: 9:16, 1-2s cuts, dynamic movement, dramatic lighting + +### 3. Audio Production + +**From `content/production/audio.md`**: + +**Voice Pipeline**: +1. **CapCut AI voice cleanup** - Normalize accents, remove artifacts +2. **ElevenLabs transformation** - Voice cloning or style transfer + +**LUFS Levels**: +- **TikTok/Reels**: -10 to -12 LUFS (louder for mobile) +- **Shorts**: -12 to -14 LUFS (moderate) +- **Snapchat**: -10 to -12 LUFS (louder for mobile) + +**Audio Mix**: +- Dialogue: -10 LUFS (primary) +- Music: -18 to -20 LUFS (background) +- SFX: varies (-5 to -15 LUFS) + +**Trending Sound Pairing**: +- TikTok: Use trending sound as background, voiceover on top +- Reels: Original audio preferred, trending sound for discovery +- Shorts: YouTube Audio Library or original + +### 4. Captions and Text Overlays + +**Caption Requirements**: +- 80%+ of viewers watch without sound +- Auto-captions via CapCut, Descript, or platform tools +- Edit for accuracy (AI captions are 85-95% accurate) +- Style: Bold, high contrast, easy to read on mobile + +**Text Overlay Strategy**: +- Hook text in first frame (1-3s) +- Key points as text overlays (2-3 per video) +- CTA text at end (1-3s) +- Font: Bold, sans-serif, high contrast +- Position: Center or lower third (avoid top for platform UI) + +**CapCut Auto-Captions**: + +```bash +# Upload video to CapCut +# Text → Auto Captions → Select language +# Edit for accuracy +# Style: Bold, white text, black outline +# Export with captions burned in +``` + +## Optimization and Testing + +### A/B Testing (from `content/optimization.md`) + +**Hook Variants**: +- Test 5-10 different hooks per topic +- Same content, different first 3 seconds +- Measure completion rate and shares + +**Thumbnail Variants** (Shorts and Reels): +- Test 3-5 thumbnail images +- Measure click-through rate from feed + +**Sound Variants**: +- Test trending sound vs original audio +- Measure reach and engagement + +**250-Sample Rule**: +- Wait for 250+ views before judging performance +- Below 2% engagement = kill +- Above 2% engagement = scale (boost or repost) +- Above 3% engagement = go aggressive (paid promotion) + +### Platform-Specific Metrics + +**TikTok**: +- **Completion rate** - % who watch to end (target: 60%+) +- **Shares** - Shares to friends or other platforms (target: 5%+) +- **Saves** - Saves to favorites (target: 3%+) +- **Watch time** - Total minutes watched (higher = more reach) + +**Reels**: +- **Shares to Stories** - Shares to Instagram Stories (target: 5%+) +- **Saves** - Saves to collections (target: 3%+) +- **Completion rate** - % who watch to end (target: 50%+) +- **Profile visits** - Clicks to profile (target: 2%+) + +**Shorts**: +- **Watch time** - Total minutes watched (primary metric) +- **CTR** - Click-through rate from Shorts feed (target: 5%+) +- **Subscribes** - New subscribers from Short (target: 1%+) +- **Engagement rate** - Likes + comments / views (target: 3%+) + +### Retention Analysis + +**Scene-Level Retention**: +- Identify exact moment viewers drop off +- Analyze first 3s retention (hook effectiveness) +- Analyze mid-video retention (storytelling effectiveness) +- Analyze end retention (CTA effectiveness) + +**TikTok Analytics**: +- Creator Tools → Analytics → Content → Select video +- Scroll to "Audience retention" graph +- Identify drop-off points + +**Reels Insights**: +- Instagram → Profile → Menu → Insights → Content → Reels +- Select Reel → Swipe up for detailed metrics +- "Plays" graph shows retention curve + +**Shorts Analytics**: +- YouTube Studio → Content → Shorts → Select Short +- Analytics tab → Engagement → "Average view duration" +- Identify drop-off points in timeline + +## Cross-Platform Strategy + +### Repurposing Workflow + +**One Video → Three Platforms**: + +1. **Create master version** (9:16, 60s, captions burned in) +2. **TikTok** - Upload master, add trending sound, 3-5 hashtags +3. **Reels** - Upload master, original audio or trending sound, 3-5 hashtags +4. **Shorts** - Upload master, add title/description, #Shorts + topic tags + +**Avoid Watermarks**: +- Export clean version (no TikTok/Reels watermark) +- All platforms penalize cross-posted content with watermarks +- Use CapCut or editing tool to export clean + +**Platform-Specific Edits**: +- TikTok: Add trending sound overlay +- Reels: Add location tag and product tags (if applicable) +- Shorts: Add end screen with subscribe button + +### Content Calendar + +**Posting Cadence**: +- **TikTok**: 1-3 per day +- **Reels**: 1-2 per day +- **Shorts**: 1-2 per day +- **Total**: 3-7 short-form videos per day across platforms + +**Batch Production**: +- Film 10-20 videos in one session +- Edit and schedule for the week +- Use scheduling tools: Later, Hootsuite, Buffer + +**Content Mix**: +- 50% educational/value-driven +- 30% entertainment/storytelling +- 20% promotional/CTA-focused + +## Monetization Strategy + +### Affiliate Links + +**Link in Bio**: +- TikTok: Link in bio (1 link only, use Linktree for multiple) +- Reels: Link in bio (Instagram allows multiple links) +- Shorts: Link in description (YouTube allows multiple links) + +**Comment Pinning**: +- Pin comment with affiliate link or keyword +- "Comment 'AI' for the link" +- DM automation via ManyChat or similar + +### Info Products + +**$5-27 Price Point**: +- Digital products (templates, guides, courses) +- Impulse buy pricing for cold traffic +- Upsell ladder to higher-ticket products + +**CTA Strategy**: +- Soft sell in video (benefit-focused) +- Link in bio or pinned comment +- Follow-up content with deeper value + +### Platform Monetization + +**TikTok Creator Fund**: +- 10k followers + 100k views in 30 days +- $0.02-0.04 per 1k views (low, not primary income) + +**Reels Bonus Program**: +- Invitation-only (Instagram selects creators) +- $0.01-0.05 per 1k views (varies by region) + +**Shorts Fund**: +- 1k subscribers + 10M Shorts views in 90 days +- $100-10k per month (based on performance) + +**Snapchat Spotlight**: +- Unique content (no reposts) +- $1M+ per day distributed to top creators +- Highly competitive, focus on viral content + +## Tools and Integrations + +### Editing Tools + +**CapCut** (recommended for short-form): +- Auto-captions with high accuracy +- Trending effects and transitions +- Export 9:16 with captions burned in +- Free tier sufficient for most creators + +**Descript**: +- Text-based video editing +- Auto-captions and transcription +- Voice cloning and overdub +- Paid ($12-24/month) + +**Adobe Premiere Rush**: +- Mobile and desktop editing +- Auto-reframe for 9:16 +- Cloud sync across devices +- Paid ($9.99/month) + +### Scheduling Tools + +**Later** (Instagram and TikTok): +- Schedule Reels and TikToks +- Visual content calendar +- Analytics and reporting +- Free tier: 10 posts/month + +**Hootsuite** (multi-platform): +- Schedule TikTok, Reels, Shorts +- Bulk upload and scheduling +- Team collaboration +- Paid ($99+/month) + +**Buffer** (multi-platform): +- Schedule TikTok, Reels, Shorts +- Analytics and reporting +- Free tier: 3 channels, 10 posts/channel + +### Analytics Tools + +**TikTok Analytics** (built-in): +- Creator Tools → Analytics +- Follower demographics, content performance, trending sounds + +**Instagram Insights** (built-in): +- Profile → Menu → Insights +- Reels performance, audience demographics, reach + +**YouTube Studio** (built-in): +- Content → Shorts → Analytics +- Watch time, CTR, engagement, traffic sources + +**Third-Party Analytics**: +- **Pentos** (TikTok analytics) +- **Socialinsider** (multi-platform) +- **Sprout Social** (enterprise) + +## Related Agents and Tools + +**Content Pipeline**: +- `content/research.md` - Audience research and niche validation +- `content/story.md` - Hook formulas and narrative design +- `content/production/writing.md` - Script structure and pacing +- `content/production/video.md` - Sora 2 Pro and Veo 3.1 workflows +- `content/production/audio.md` - Voice pipeline and LUFS levels +- `content/optimization.md` - A/B testing and analytics loops + +**Distribution Channels**: +- `content/distribution/youtube/` - Long-form YouTube content +- `content/distribution/social.md` - X, LinkedIn, Reddit +- `content/distribution/blog.md` - SEO-optimized articles + +**Tools**: +- `tools/video/higgsfield.md` - AI video generation +- `tools/video/video-prompt-design.md` - Video prompting frameworks +- `tools/voice/speech-to-speech.md` - Voice cloning and transformation +- `tools/social-media/` - Platform-specific automation + +## Examples + +### Example 1: Educational Short (AI Tutorial) + +**Hook (0-2s)**: + +```text +[Visual: Extreme close-up of shocked face] +[Text: "ChatGPT can't do THIS"] +[Narration: "ChatGPT can't do this, but this AI tool can..."] +``` + +**Problem (2-5s)**: + +```text +[Visual: Screen recording of ChatGPT limitation] +[Text: "ChatGPT = text only"] +[Narration: "...ChatGPT only does text, but I need video."] +``` + +**Solution (5-15s)**: + +```text +[Visual: Screen recording of Sora 2 Pro interface] +[Text: "Sora 2 Pro = AI video"] +[Narration: "So I used Sora 2 Pro to generate this entire video from a text prompt."] + +[Visual: Generated video playing] +[Text: "100% AI-generated"] +[Narration: "This is 100% AI. No filming, no editing."] +``` + +**Result (15-18s)**: + +```text +[Visual: Analytics screenshot] +[Text: "10 videos/day now"] +[Narration: "Now I create 10 videos per day in minutes."] +``` + +**CTA (18-20s)**: + +```text +[Visual: Face to camera] +[Text: "Follow for AI tips"] +[Narration: "Follow for more AI tips."] +``` + +### Example 2: Entertainment Short (Before/After Transformation) + +**Hook (0-2s)**: + +```text +[Visual: Split screen - "Before" side shows amateur video] +[Text: "My videos looked like THIS"] +[Narration: "My videos used to look like this..."] +``` + +**Journey (2-10s)**: + +```text +[Visual: Montage of testing different tools - 4 x 2s cuts] +[Text: "Tested 10 AI tools"] +[Narration: "...I tested 10 different AI video tools..."] +``` + +**Solution (10-15s)**: + +```text +[Visual: Split screen - "After" side shows professional video] +[Text: "Now they look like THIS"] +[Narration: "...and now they look like this."] +``` + +**Result (15-18s)**: + +```text +[Visual: Follower count graph going up] +[Text: "0 → 50k in 30 days"] +[Narration: "I went from 0 to 50k followers in 30 days."] +``` + +**CTA (18-20s)**: + +```text +[Visual: Face to camera] +[Text: "Comment 'AI' for the tool"] +[Narration: "Comment 'AI' and I'll send you the tool."] +``` + +### Example 3: UGC-Style Product Showcase + +**Hook (0-2s)**: + +```text +[Visual: Handheld POV of product in hand] +[Text: "This AI tool is INSANE"] +[Narration: "This AI tool is absolutely insane..."] +``` + +**Problem (2-5s)**: + +```text +[Visual: Screen recording of manual editing workflow] +[Text: "I used to spend 4 hours editing"] +[Narration: "...I used to spend 4 hours editing one video..."] +``` + +**Solution (5-15s)**: + +```text +[Visual: Screen recording of AI tool interface] +[Text: "Now it takes 10 minutes"] +[Narration: "...now it takes 10 minutes with this AI tool."] + +[Visual: Generated video playing] +[Text: "Auto-captions, auto-cuts, auto-everything"] +[Narration: "Auto-captions, auto-cuts, auto-everything."] +``` + +**Result (15-18s)**: + +```text +[Visual: Calendar showing daily posts] +[Text: "I post 3x per day now"] +[Narration: "I went from 1 video per week to 3 per day."] +``` + +**CTA (18-20s)**: + +```text +[Visual: Product logo on screen] +[Text: "Link in bio"] +[Narration: "Link in bio to try it free."] +``` diff --git a/.agents/content/distribution/social.md b/.agents/content/distribution/social.md new file mode 100644 index 0000000000..fd511a7898 --- /dev/null +++ b/.agents/content/distribution/social.md @@ -0,0 +1,295 @@ +--- +name: social +description: Social media distribution - X, LinkedIn, Reddit platform-native content +mode: subagent +model: sonnet +--- + +# Social - X, LinkedIn, and Reddit Distribution + + + +## Quick Reference + +- **Purpose**: Distribute content across social platforms with platform-native tone and format +- **Platforms**: X (Twitter), LinkedIn, Reddit +- **Key Principle**: Same story, different delivery - adapt voice and format per platform +- **Success Metrics**: Engagement rate, shares, profile visits, link clicks + +**Critical Rules**: + +- **Platform-native tone** - Each platform has distinct expectations; cross-posting identical content underperforms +- **No promotional language on Reddit** - Community-first, value-first, or get downvoted +- **Hook-first on X** - Front-load value in first line (visible before truncation) +- **Professional framing on LinkedIn** - Thought leadership, not sales pitch +- **One idea per post** - Clarity beats comprehensiveness on social + +**Platform Tool References**: + +- `tools/social-media/bird.md` - X (Twitter) automation and scheduling +- `tools/social-media/linkedin.md` - LinkedIn posting and analytics +- `tools/social-media/reddit.md` - Reddit engagement and community management + + + +## Platform Profiles + +### X (Twitter) + +**Voice**: Concise, opinionated, personality-forward. Sharpest and most direct of all platforms. + +**Formats**: + +| Format | Length | Best For | +|--------|--------|----------| +| **Single post** | 1-2 sentences (under 280 chars) | Hot takes, links, announcements | +| **Thread** | 3-10 posts | Breakdowns, stories, tutorials | +| **Quote post** | 1 sentence + context | Commentary, amplification | +| **Poll** | Question + 2-4 options | Engagement, audience research | + +**Thread Structure**: + +1. **Hook post** - Bold claim, surprising stat, or question (this determines reach) +2. **Context** - Why this matters, who it's for +3. **Body** - 3-7 posts with one insight each +4. **Summary** - Key takeaway in one sentence +5. **CTA** - Follow, repost, bookmark, or link + +**Best Practices**: + +- Front-load value - no preamble, no "I've been thinking about..." +- Number thread posts (1/7) for readability +- One idea per post +- Use line breaks for scannability +- Optimal posting: weekdays, 9-11am and 1-3pm local time +- Hashtags: 0-2 maximum (X penalizes hashtag spam) + +**Content Adaptation from Pipeline**: + +```text +Story: "Why 95% of AI influencers fail" + +X Thread (7 posts): +1/ 95% of AI influencers will fail this year. Not because the tech is bad. Because they're making the same 5 mistakes. +2/ Mistake 1: They chase tools, not problems. Nobody cares about your Sora 2 demo. They care about solving their video production bottleneck. +3/ Mistake 2: They post AI-generated content without editing. Your audience can tell. They always can. +... +7/ The 5% who succeed? They research first, create second, and optimize third. That's the entire playbook. Follow for the deep dive. +``` + +### LinkedIn + +**Voice**: Professional, authoritative, thought-leadership. More formal than X, less formal than whitepaper. + +**Formats**: + +| Format | Length | Best For | +|--------|--------|----------| +| **Text post** | 150-300 words | Opinions, lessons, quick insights | +| **Article** | 800-2,000 words | Deep dives, case studies | +| **Carousel** | 8-12 slides, 20-40 words each | Frameworks, step-by-step guides | +| **Document** | 5-15 pages | Reports, playbooks | +| **Poll** | Question + 4 options | Engagement, market research | + +**Post Structure**: + +1. **Hook line** - Question, bold claim, or surprising stat (visible before "see more") +2. **Line break** - Forces "see more" click +3. **Body** - One thought per line, liberal line breaks +4. **Insight** - Key takeaway or lesson +5. **CTA** - Question to drive comments, or link + +**Best Practices**: + +- Open with a hook that stops the scroll +- Use line breaks liberally - one thought per line +- End with a question or clear CTA to drive engagement +- Hashtags: 3-5 relevant ones, placed at the end +- Avoid: corporate jargon, "excited to announce", empty self-promotion +- Optimal posting: Tuesday-Thursday, 8-10am local time +- Personal stories outperform corporate announcements + +**Content Adaptation from Pipeline**: + +```text +Story: "Why 95% of AI influencers fail" + +LinkedIn Post: +Most AI influencers will fail this year. + +Not because the technology isn't good enough. + +Because they're solving the wrong problem. + +I spent 6 months studying the top 50 AI content creators. +The pattern was clear: + +The ones who succeed don't talk about tools. +They talk about outcomes. + +Here's what separates the 5% who make it: + +1. They research their audience before creating content +2. They edit AI output ruthlessly (your audience can always tell) +3. They optimize based on data, not gut feeling +4. They build systems, not one-off posts +5. They solve real problems, not demo features + +The AI content gold rush is real. +But the winners won't be the ones with the best tools. + +They'll be the ones who understand their audience best. + +What's your biggest challenge with AI content? Drop it below. + +#AIContent #ContentStrategy #CreatorEconomy +``` + +### Reddit + +**Voice**: Community-native, authentic, anti-promotional. Reddit users detect and punish marketing instantly. + +**Formats**: + +| Format | Best For | +|--------|----------| +| **Text post** | Discussions, questions, sharing experiences | +| **Link post** | Sharing resources (with genuine context) | +| **Comment** | Adding value to existing discussions | +| **AMA** | Building authority in a niche | + +**Subreddit Strategy**: + +1. **Identify target subreddits** - Where does your audience discuss your topic? +2. **Lurk first** - Understand community norms, rules, and tone +3. **Add value** - Answer questions, share experiences, provide resources +4. **Build karma** - Genuine participation before any self-promotion +5. **Share content** - Only when genuinely relevant and valuable + +**Best Practices**: + +- **Never** lead with self-promotion - provide value first +- Write like a community member, not a marketer +- Share personal experience and lessons learned +- Use the subreddit's language and conventions +- Respond to comments on your posts +- Follow each subreddit's self-promotion rules (typically 10:1 ratio) +- Optimal posting: weekday mornings (US time zones) + +**Content Adaptation from Pipeline**: + +```text +Story: "Why 95% of AI influencers fail" + +Reddit Post (r/artificial): +Title: After studying 50 AI content creators for 6 months, here's what separates the ones who make it + +I've been tracking AI content creators since mid-2025. Not as a fan - as someone trying to understand what actually works. + +The short version: most of them are doing the same thing wrong. + +They demo tools instead of solving problems. Their audience doesn't care about Sora 2 Pro's new features. They care about making better videos faster. + +The creators who are actually growing: +- Research their audience obsessively (Reddit is a goldmine for this) +- Edit AI output until it doesn't feel like AI +- Test 10 variants before committing to one approach +- Build repeatable systems instead of one-off viral attempts + +Happy to share more details on the research methodology if anyone's interested. + +[No links, no self-promotion, genuine discussion starter] +``` + +## Cross-Platform Strategy + +### Content Adaptation Matrix + +| Source Asset | X | LinkedIn | Reddit | +|-------------|---|----------|--------| +| **YouTube video** | Key insight thread (5-7 posts) | Case study post (200-300 words) | Discussion post with learnings | +| **Blog post** | Thread with main takeaways | Article repost or summary | Link post with genuine context | +| **Short-form video** | Embed with hook text | Native video upload | Link to YouTube (if allowed) | +| **Research finding** | Single punchy post | Data-driven thought piece | Detailed methodology share | +| **Case study** | Before/after thread | Full narrative post | Experience-sharing post | + +### Posting Cadence + +| Platform | Frequency | Best Times | Content Mix | +|----------|-----------|------------|-------------| +| **X** | 3-5 posts/day | 9-11am, 1-3pm | 50% value, 30% engagement, 20% promotion | +| **LinkedIn** | 1-2 posts/day | Tue-Thu, 8-10am | 60% thought leadership, 30% stories, 10% promotion | +| **Reddit** | 2-3 posts/week | Weekday mornings | 90% value/discussion, 10% content sharing | + +### Batch Production Workflow + +1. **Start with story** from `content/story.md` +2. **Generate platform variants** using adaptation matrix above +3. **Review tone** against platform profiles +4. **Schedule** using platform tools or Buffer/Hootsuite +5. **Monitor** engagement and iterate + +## Engagement Strategy + +### X Engagement + +- Reply to comments within 1 hour +- Quote-repost relevant industry posts with your take +- Engage with 10-20 accounts in your niche daily +- Pin your best-performing thread + +### LinkedIn Engagement + +- Reply to every comment on your posts (algorithm boost) +- Comment on 5-10 posts from your network daily +- Share others' content with your perspective added +- Join and participate in relevant LinkedIn groups + +### Reddit Engagement + +- Answer questions in your niche subreddits daily +- Upvote and comment on quality posts +- Build genuine relationships with community members +- Never argue - provide evidence and move on + +## Analytics and Optimization + +### Key Metrics per Platform + +| Platform | Primary Metric | Secondary Metrics | +|----------|---------------|-------------------| +| **X** | Impressions + engagement rate | Profile visits, link clicks, follower growth | +| **LinkedIn** | Engagement rate + reach | Profile views, connection requests, article reads | +| **Reddit** | Upvotes + comment quality | Karma growth, cross-post performance | + +### A/B Testing (from `content/optimization.md`) + +- Test 3-5 hook variants per topic +- Measure engagement rate (not just likes) +- 250-impression minimum before judging +- Below 2% engagement = revise approach +- Above 3% engagement = scale and repurpose + +## Related Agents and Tools + +**Content Pipeline**: + +- `content/research.md` - Audience research and niche validation +- `content/story.md` - Hook formulas and narrative design +- `content/platform-personas.md` - Legacy platform voice adaptations +- `content/optimization.md` - A/B testing and analytics loops + +**Distribution Channels**: + +- `content/distribution/youtube/` - Long-form YouTube content +- `content/distribution/short-form.md` - TikTok, Reels, Shorts +- `content/distribution/blog.md` - SEO-optimized articles +- `content/distribution/email.md` - Newsletters and sequences +- `content/distribution/podcast.md` - Audio-first distribution + +**Tools**: + +- `tools/social-media/bird.md` - X (Twitter) automation +- `tools/social-media/linkedin.md` - LinkedIn posting +- `tools/social-media/reddit.md` - Reddit engagement +- `content/humanise.md` - Remove AI writing patterns diff --git a/.agents/content/distribution/youtube/README.md b/.agents/content/distribution/youtube/README.md new file mode 100644 index 0000000000..43d23cad08 --- /dev/null +++ b/.agents/content/distribution/youtube/README.md @@ -0,0 +1,79 @@ +--- +name: youtube-distribution +description: YouTube long-form distribution - references root youtube/ agents +mode: subagent +model: sonnet +--- + +# YouTube Distribution + + + +## Quick Reference + +- **Purpose**: YouTube long-form video distribution within the content pipeline +- **Authoritative Source**: Root `youtube.md` and `youtube/` subagents +- **This Directory**: Reference agents that integrate YouTube into the content distribution pipeline + +**This is a distribution channel reference**. The full YouTube agent lives at the root level (`youtube.md`) with its subagents in `youtube/`. This directory provides the distribution-pipeline integration point so the content orchestrator (`content.md`) can fan out to YouTube alongside other channels. + + + +## Subagents (Root References) + +| Subagent | Source | Purpose | +|----------|--------|---------| +| `channel-intel` | `youtube/channel-intel.md` | Competitor analysis, outlier detection | +| `topic-research` | `youtube/topic-research.md` | Niche trends, content gaps, keyword clustering | +| `script-writer` | `youtube/script-writer.md` | Long-form scripts with hooks and retention curves | +| `optimizer` | `youtube/optimizer.md` | Title, description, tags, thumbnail optimization | +| `pipeline` | `youtube/pipeline.md` | End-to-end automation pipeline | + +## Distribution Workflow + +When the content pipeline fans out to YouTube: + +1. **Receive story and production assets** from upstream pipeline stages +2. **Adapt to YouTube format** using `youtube/script-writer.md` + - Long-form script (8-20 minutes) + - Scene-by-scene breakdown with B-roll directions + - Hook optimization for first 30 seconds +3. **Optimize metadata** using `youtube/optimizer.md` + - Title variants with CTR signals + - SEO-optimized description with timestamps + - Tag generation (primary + long-tail + competitor) + - Thumbnail brief +4. **Publish and monitor** using `youtube/pipeline.md` + +## YouTube-Specific Format Rules + +| Parameter | Specification | +|-----------|--------------| +| **Aspect ratio** | 16:9 (landscape) | +| **Resolution** | 1080p minimum, 4K preferred | +| **Length** | 8-20 minutes (optimal for ad revenue) | +| **Thumbnail** | 1280x720, high contrast, readable text | +| **Title** | Under 60 characters, keyword-front | +| **Description** | First 2 lines visible, timestamps, links | +| **Tags** | 5-10 relevant keywords | +| **Chapters** | Timestamps for videos over 5 minutes | + +## Cross-Channel Repurposing + +From one YouTube video, generate: + +- **YouTube Short** - Best 30-60s clip, 9:16 reformat (`content/distribution/short-form.md`) +- **Blog post** - Transcript-based SEO article (`content/distribution/blog.md`) +- **Social posts** - Key insights as X thread, LinkedIn post, Reddit discussion (`content/distribution/social.md`) +- **Email** - Newsletter featuring video + key takeaways (`content/distribution/email.md`) +- **Podcast** - Audio-only version with show notes (`content/distribution/podcast.md`) + +## Related Agents + +- `youtube.md` - Root YouTube agent (authoritative) +- `youtube/` - Root YouTube subagents +- `content/production/video.md` - Video generation (Sora 2 Pro, Veo 3.1) +- `content/production/audio.md` - Voice pipeline +- `content/story.md` - Narrative design and hook formulas +- `content/optimization.md` - A/B testing and analytics +- `youtube-helper.sh` - YouTube Data API v3 wrapper