Skip to content

svenkatreddy/universal-video-skills / skills/assembly-and-delivery

assembly-and-delivery

Verified

Stitch AI clips into a finished video: ffmpeg concat, transitions, title cards, watermarks, subtitles, and platform exports (16:9, 9:16, 1:1). Use when individual clips exist and need to become one video.

FileKindSize
SKILL.mdskill md2.1 KB
references/exports.mdmarkdown1.5 KB
references/stitching.mdmarkdown3.7 KB
scripts/concat.pyscript3.7 KB

references/stitching.md

View on GitHub
# Stitching Clips

## Before you join anything

Run `ffprobe` on every clip. All clips must agree on:

- Codec (H.264 everywhere, ideally)
- Resolution (1920×1080 everywhere, not "mostly")
- Frame rate (24 or 30; pick one per project)
- Pixel format (`yuv420p` for compatibility)
- Audio: sample rate and channel count, or no audio at all

One odd clip poisons the concat. Transcode the odd one out first, matching
the project's audio standard: `concat.py` compares the audio fingerprint,
so a silent clip and a clip with audio never join, even when the video
matches.

Project clips have audio and the odd clip's audio settings are wrong:

```bash
ffmpeg -i odd.mp4 -c:v libx264 -pix_fmt yuv420p -r 30 -s 1920x1080 \
       -c:a aac -ar 48000 -ac 2 odd-fixed.mp4
```

Project clips are silent: strip the odd clip's audio. The command above
will not do it for you: with no audio stream in the input, ffmpeg has
nothing to encode, so the output stays silent-or-not exactly as it was.
Be explicit:

```bash
ffmpeg -i odd.mp4 -c:v libx264 -pix_fmt yuv420p -r 30 -s 1920x1080 \
       -an odd-fixed.mp4
```

Project clips have audio and the odd clip is silent: give it a silent
track so the fingerprints agree:

```bash
ffmpeg -i odd.mp4 -f lavfi -i anullsrc=r=48000:cl=stereo \
       -c:v libx264 -pix_fmt yuv420p -r 30 -s 1920x1080 \
       -c:a aac -ar 48000 -ac 2 -shortest odd-fixed.mp4
```

## The concat

Use the concat demuxer (lossless, no re-encode) via `scripts/concat.py`:

```bash
python3 scripts/concat.py clip1.mp4 clip2.mp4 clip3.mp4 -o master.mp4
```

The script verifies each input with ffprobe, writes the file list, runs the
concat, then checks the output duration against the sum of inputs. If the
numbers don't add up, it tells you.

## Transitions

The concat demuxer does hard cuts only. For dissolves or fades between
specific clips, use `xfade` on those two clips first, then concat the result:

```bash
ffmpeg -i a.mp4 -i b.mp4 -filter_complex \
  "[0:v][1:v]xfade=transition=fade:duration=0.5:offset=7.5[v]" \
  -map "[v]" ab.mp4
```

`offset` is when the fade starts: the first clip's duration minus the
fade duration (7.5 = 8 - 0.5 here). Note this maps video only, so
`ab.mp4` comes out silent. If the project has audio, carry it through
with `acrossfade` (same duration as the video fade) instead of dropping
it, or the concat gate will fail on the audio mismatch:

```bash
ffmpeg -i a.mp4 -i b.mp4 -filter_complex \
  "[0:v][1:v]xfade=transition=fade:duration=0.5:offset=7.5[v]; \
   [0:a][1:a]acrossfade=d=0.5[a]" \
  -map "[v]" -map "[a]" -c:v libx264 -pix_fmt yuv420p -c:a aac ab.mp4
```

Rules of thumb:

- **Hard cuts** between shots in a sequence. Default.
- **Fade through black** (0.3–0.5s) for time jumps and act breaks.
- **Dissolves** for memory, dreams, passage of time. Rarely for anything
  else.
- **No transition** is a transition. When in doubt, cut.

## Finishing

- **Title card:** 2–3 seconds, project style. Generate it or build it in
  ffmpeg (`drawtext`). Keep the font files in the project.
- **Watermark:** small, corner, semi-transparent, throughout. Burn it in on
  the master so every export inherits it.
- **Subtitles:** sidecar `.srt` for YouTube; burned-in for platforms that
  strip sidecars. Same source file either way
  (`../../dialogue-and-audio/references/subtitles.md`).
- **Credits card:** end card, 3–4 seconds. Who made it, with what, sources
  if the content needs them.

## The join check

After assembly, watch 2 seconds on each side of every cut and ask:

1. Does the geography connect? (No teleports.)
2. Does the light match? (No noon-to-midnight cuts unless intended.)
3. Does the audio bridge? (Room tone continuous, no clicks.)
4. Does the pace breathe? (Not every cut at the same rhythm.)

Fix the clip or the cut. Never ship a join you flinched at.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall