Abhi5415/.claude/skills/_archived/tiktok-quote-video

TikTok Quote Overlay Video

Produce ambient quote overlay TikTok videos for Clarido — text quotes over looping background video. Series-based (e.g., "Harsh Truths for Overthinkers 1/30"). No voiceover, no illustrations. High volume, highly batchable.

When to Use

Use this skill when the user wants to create TikTok quote overlay content — short ambient videos with text quotes over background footage.

Pipeline Phases

Phase 1: Series Planning (interactive)

1. User provides series concept (or Claude suggests options)
2. Generate quotes.json with all quotes, captions, hashtags, and bg video assignments
3. Suggest background video prompts (ambient, moody, cinematic — no people, no text)
4. User approves quotes + bg video prompts

quotes.json format:

{
  "series": "Harsh Truths for Overthinkers",
  "total": 30,
  "quotes": [
    {
      "number": 1,
      "text": "Overthinking isn't depth — it's wearing intelligence as a disguise.",
      "bg_video": "merry-go-round.mp4",
      "caption": "Stop confusing overthinking with being thorough. #overthinking #psychology",
      "hashtags": "#overthinkers #harshtruths #psychology #mentalhealth #clarity"
    }
  ]
}

Phase 2: Background Video Generation (automated)

Generate background videos via Fal AI Kling V3 Pro:

pipenv run python3 scripts/tiktok/generate_bg_video.py \
    "Slow motion merry-go-round at dusk, warm golden light, dreamy atmosphere" \
    content/tiktok-quotes/{series-slug}/bg-videos/merry-go-round.mp4

• 9:16 aspect ratio, 5s duration (loops in Remotion), no audio
• Multiple quotes can share the same background video
• Build a pool of 5-10 backgrounds per series of 30

Phase 3: Render (automated)

Batch render all quotes:

pipenv run python3 scripts/tiktok/render_quote_batch.py \
    content/tiktok-quotes/{series-slug}

# Or render a subset:
pipenv run python3 scripts/tiktok/render_quote_batch.py \
    content/tiktok-quotes/{series-slug} --range 1-5

Output lands in content/tiktok-quotes/{series-slug}/rendered/.

Folder Structure

content/tiktok-quotes/
└── {series-slug}/
    ├── quotes.json
    ├── bg-videos/
    │   ├── merry-go-round.mp4
    │   └── rainy-window.mp4
    └── rendered/
        ├── 01.mp4
        └── 02.mp4

Remotion Composition

• ID: QuoteOverlay (in TikTok folder)
• Size: 1080x1920, 30fps
• Duration: 8s default (configurable via durationInSeconds prop)
• Props: seriesName, quoteNumber, totalQuotes, quoteText, bgVideo, durationInSeconds

Background Video Prompt Tips

Good prompts for ambient backgrounds:

• Nature: "Slow aerial shot of fog rolling through a forest valley at dawn"
• Urban: "Rain drops on a window at night, blurred city lights in background"
• Abstract: "Slow motion ink drops spreading in water, dark moody lighting"
• Nostalgic: "Empty merry-go-round spinning slowly at dusk, warm golden light"

Avoid: people's faces, text/signs, fast motion, bright/harsh lighting.