short-form-pipeline
Extract viral short-form clips (TikTok, Reels, Shorts) from long-form YouTube videos. Handles download, transcription, AI segmentation, cutting, vertical cropping, and caption burn-in.
Install / Use
npx skills add ericosiu/ai-marketing-skills --skill short-form-pipelineInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of short-form-pipeline
short-form-pipeline scores 89/100 on our quality scale, 1349th of 2,790 Automation skills we index (top 49%).
Its SKILL.md is 3.8 KB long, well organised into 17 sections with 3 code examples: a solid amount of guidance for an agent.
With 3,573 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so short-form-pipeline is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
short-form-pipeline compared with similar skills
All 4 of these similar skills score higher than short-form-pipeline; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| short-form-pipeline (this skill)by ericosiu | 89 | 3.6k | 55d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install short-form-pipeline?
- Run
npx skills add ericosiu/ai-marketing-skills --skill short-form-pipeline. The install tabs above show the steps for each supported agent. - Which AI agents does short-form-pipeline work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is short-form-pipeline safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is short-form-pipeline still maintained?
- The repository was last updated about 2 months ago, so short-form-pipeline is actively maintained.
Skill content
View source on GitHubShort-Form Video Clip Pipeline — Skill
Preamble (runs on skill start)
# Version check (silent if up to date)
python3 telemetry/version_check.py 2>/dev/null || true
# Telemetry opt-in (first run only, then remembers your choice)
python3 telemetry/telemetry_init.py 2>/dev/null || true
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. Seetelemetry/README.md.
Extract viral short-form clips (TikTok, Reels, Shorts) from long-form YouTube videos. Handles download, transcription, AI segmentation, cutting, vertical cropping, and caption burn-in.
Prerequisites
yt-dlpandffmpeginstalledANTHROPIC_API_KEYenvironment variable set- Python dependencies from
requirements.txtinstalled - Optional:
mediapipeandopencv-pythonfor face-detected smart crop
Quick Start
Single video → clips
python3 scripts/shortform_pipeline.py \
--url "https://www.youtube.com/watch?v=VIDEO_ID" \
--max-clips 3 \
--output-dir ./output
Standalone clipper (no Claude, heuristic scoring)
python3 scripts/video_clipper.py --url "https://www.youtube.com/watch?v=VIDEO_ID"
Pipeline Overview
- Download — yt-dlp fetches video + auto-generated VTT captions
- Transcribe — Whisper generates word-level timestamps (falls back to YouTube captions)
- Segment — Claude identifies 2–5 best 30–60s moments with hook scoring ≥7/10
- Cut Verification — Second Claude pass verifies each clip ends on a complete thought
- Cut — FFmpeg extracts each clip from the source video
- Vertical Crop — Layout-aware 16:9 → 9:16 conversion with face detection
- Caption Burn — TikTok-style word-highlighted captions (ASS format) burned in
Key Files
| File | Purpose |
|------|---------|
| scripts/shortform_pipeline.py | Full pipeline: download → segment → cut → crop → caption |
| scripts/video_clipper.py | Standalone clipper with heuristic scoring (no Claude needed) |
| scripts/clip_sender.py | Helper for clip delivery and review workflow |
Layout-Aware Cropping
The pipeline handles four video layouts differently:
talking_head— Face-detected center crop using MediaPipe; audio panning fallbackscreen_share_overlay— Stacks screen content on top, webcam bubble on bottomside_by_side— Stacks screen on top, presenter face on bottomgallery_view— Crops to active speaker quadrant
Claude outputs a layout_hint for each segment during segmentation.
Customization
Voice patterns
Edit VOICE_PATTERNS in video_clipper.py to match your creator's speech patterns. These boost clip scoring for authentic-sounding segments.
Segmentation prompt
The Claude prompt in shortform_pipeline.py can be customized:
- Adjust
hook_strengthminimum (default: 7/10) - Change target duration range (default: 30–60s)
- Modify layout hint options
Crop tuning
In video_clipper.py:
scale_factor— Zoom level for single face (default: 1.08)desired_face_y— Target face position in frame (default: upper 35%)
Output
Each clip is output as:
- 1080×1920 resolution (9:16 vertical)
- H.264 + AAC encoding
- Word-highlighted captions burned in
- Ready for direct upload to TikTok, Reels, or Shorts
Troubleshooting
- FFmpeg filter_complex error: Don't use
-c:v copywith-filter_complex. Only-c:a copyis safe. - Wrong output resolution: Always crop before scaling. Verify with
ffprobe -show_entries stream=width,height. - Caption sync issues: Run Whisper on the cut clip, not the source episode.
- TikTok upload fails: Ensure H.264 + AAC encoding. Add
-c:v libx264 -c:a aacif needed. - Clip too long: Claude sometimes overshoots. The pipeline auto-trims clips >90s to 75s.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
