short-form-pipeline

1# Short-Form Video Clip Pipeline — Skill
2 
3## Preamble (runs on skill start)
4 
5```bash
6# Version check (silent if up to date)
7python3 telemetry/version_check.py 2>/dev/null || true
8 
9# Telemetry opt-in (first run only, then remembers your choice)
10python3 telemetry/telemetry_init.py 2>/dev/null || true
11```
12 
13> **Privacy:** This skill logs usage locally to `~/.ai-marketing-skills/analytics/`. Remote telemetry is opt-in only. No code, file paths, or repo content is ever collected. See `telemetry/README.md`.
14 
15---
16 
17Extract viral short-form clips (TikTok, Reels, Shorts) from long-form YouTube videos. Handles download, transcription, AI segmentation, cutting, vertical cropping, and caption burn-in.
18 
19## Prerequisites
20 
21- `yt-dlp` and `ffmpeg` installed
22- `ANTHROPIC_API_KEY` environment variable set
23- Python dependencies from `requirements.txt` installed
24- Optional: `mediapipe` and `opencv-python` for face-detected smart crop
25 
26## Quick Start
27 
28### Single video → clips
29 
30```bash
31python3 scripts/shortform_pipeline.py \
32  --url "https://www.youtube.com/watch?v=VIDEO_ID" \
33  --max-clips 3 \
34  --output-dir ./output
35```
36 
37### Standalone clipper (no Claude, heuristic scoring)
38 
39```bash
40python3 scripts/video_clipper.py --url "https://www.youtube.com/watch?v=VIDEO_ID"
41```
42 
43## Pipeline Overview
44 
451. **Download** — yt-dlp fetches video + auto-generated VTT captions
462. **Transcribe** — Whisper generates word-level timestamps (falls back to YouTube captions)
47…