# social-media-clip-creator

A subagent that turns source footage into platform-ready clips for TikTok, Reels, Shorts, Twitter and LinkedIn, with cropping, captions and thumbnails.

- subagent · `type=agent` · Claude Code · 970 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/ffmpeg-clip-team/social-media-clip-creator.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/social-media-clip-creator

## What it does

This subagent scans a source video, picks moments worth clipping and produces a separate version for each destination. TikTok, Instagram Reels and YouTube Shorts get 9:16 and a 60-second ceiling; Twitter gets 16:9 capped at 2 minutes 20 seconds; LinkedIn gets 16:9 up to 10 minutes. Video codec is H.264 and audio is AAC across the board.

The toolkit is a set of FFmpeg invocations: a vertical crop via `crop=ih*9/16:ih`, burning in `subs.srt`, pulling a still frame into `thumbnail.jpg`, and re-encoding with `libx264 -crf 23 -preset fast` plus `aac -b:a 128k`. Filters chain into a single pass, so crop and subtitles can happen together. Its tools are limited to Bash, Read and Write, which means everything runs on the command line.

FFmpeg has to be installed and reachable in `PATH`; without it none of those commands run. An SRT file is needed if you want burned-in captions. Each clip comes back as structured JSON: an identifier, filename, duration, aspect ratio, file size, caption status, thumbnail name and the encoding settings used.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent ffmpeg-clip-team/social-media-clip-creator
```

2. **Manually: put the files in place**
- File: `.claude/agents/social-media-clip-creator.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/social-media-clip-creator.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/social-media-clip-creator.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/ffmpeg-clip-team/social-media-clip-creator.md

## When to use it
- cut a long recording into vertical 9:16 clips
- burn an SRT subtitle track into a finished clip
- grab a thumbnail frame at a chosen second
- shrink a file to fit a platform limit without visible quality loss
- produce separate Twitter and LinkedIn cuts of the same video

## Example prompts
- Cut three 60-second vertical clips out of `lecture.mp4` for Reels
- Burn `subs.srt` into `clip.mp4` and pull a thumbnail at the 5-second mark
- Make a 16:9 LinkedIn version of `demo.mp4` and show me the metadata

## Similar
- [telegram-ads-analyst](https://affpapa.org/en/nevibecode/agents/telegram-ads-analyst.md) — subagent · ★ 26093
- [seo-snippet-hunter](https://affpapa.org/en/nevibecode/agents/seo-snippet-hunter.md) — subagent · ★ 41823
- [seo-content-writer](https://affpapa.org/en/nevibecode/agents/seo-content-writer.md) — subagent · ★ 41823
- [seo-content-refresher](https://affpapa.org/en/nevibecode/agents/seo-content-refresher.md) — subagent · ★ 41823

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 361 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md