How do I install the Broll Composite skill?

Run npx skillmds@latest add jperrello/broll-composite in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Broll Composite safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Broll Composite?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Broll Composite free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Broll Composite?

jperrello (@jperrello) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Broll Composite by jperrello — Agent Skill

Name: Broll Composite
Author: jperrello

Broll Composite

Hard-cut full-frame B-roll cutaways onto a 1080x1920 clip per broll_plan.json. During each [t0,t1] the entire frame is replaced by the cutaway (instant in/out, no crossfade/zoom); 16:9 source is scale-to-cover + SUBJECT-cropped to 1080x1920 with no bars — the slack-axis offset is chosen subject-first (MediaPipe face -> pose person -> thresholded multi-frame saliency, reusing fill-vertical's engine), so the crop sits on the actual subject instead of drifting to background texture. No transition SFX by default (BROLL_SFX=1 re-enables a short synthesized whoosh on each cutaway in/out); the podcast audio stays continuous underneath (amix'd, never replaced). Zero valid picks -> passthrough copy. Pure ffmpeg.

jperrello 8c21490 4 files · 15.2 KB Updated Sep 17, 2026

File contents

broll-composite

Applies the cutaways chosen by broll-pick. For each pick [t0,t1] the whole 1080×1920 frame is replaced by the B-roll (hard cut, no transition). The 16:9 source is scaled to COVER and SUBJECT-cropped to 1080×1920 — full-bleed, never letterboxed (same philosophy as fill-vertical). The crop offset on the slack axis follows the cutaway's subject (a face if present, else a person, else the thresholded multi-frame saliency mass), so the subject reads centered instead of sliced off to one side. The podcast audio stays continuous for the whole clip; B-roll audio is dropped. No transition SFX by default — audio stays pure stream-copy. BROLL_SFX=1 re-enables a 0.3s synthesized whoosh (make_whoosh.py, ~-15dBFS under speech) that sweeps up into each cutaway and down out of it. Runs BEFORE burn-subtitles so karaoke captions render on top of the cutaways.

Invoke

.claude/skills/broll-composite/broll-composite.sh <in_clip.mp4> <broll_plan.json> <out.mp4>

in_clip: the vertical 1080×1920 clip (from fill-vertical)
broll_plan.json: from broll-pick
out: composited clip

Behavior

Zero picks, or every clip_path missing → copy-passthrough, exit 0.
A pick whose clip_path no longer exists is skipped; remaining picks apply.
ffmpeg failure → falls back to passthrough (never blocks the pipeline).

Idempotency

Caches on in_clip+plan mtimes + BROLL_SFX via <out>.compmeta.

Notes

Subject-cover crop reuses fill-vertical's framing engine (build_filter.py imports fill_vertical for face/pose detection): per cutaway it samples 5 frames and picks the slack-axis offset face -> person -> thresholded multi-frame saliency. Still COVER (no extra punch-in) — only WHERE the crop sits changes. Degrades to a centered crop when MediaPipe/cv2 are unavailable.
Whole video is re-encoded (overlay can't partial stream-copy); audio is amix'd with the whoosh bed to AAC 192k (or -c:a copy when BROLL_SFX=0 / no picks). Uses _lib/encode.sh (VideoToolbox/x264) + thread caps.

---name: broll-compositedescription: Hard-cut full-frame B-roll cutaways onto a 1080x1920 clip per broll_plan.json. During each [t0,t1] the entire frame is replaced by the cutaway (instant in/out, no crossfade/zoom); 16:9 source is scale-to-cover + SUBJECT-cropped to 1080x1920 with no bars — the slack-axis offset is chosen subject-first (MediaPipe face -> pose person -> thresholded multi-frame saliency, reusing fill-vertical's engine), so the crop sits on the actual subject instead of drifting to background texture. No transition SFX by default (BROLL_SFX=1 re-enables a short synthesized whoosh on each cutaway in/out); the podcast audio stays continuous underneath (amix'd, never replaced). Zero valid picks -> passthrough copy. Pure ffmpeg.---# broll-compositeApplies the cutaways chosen by broll-pick. For each pick `[t0,t1]` the whole1080×1920 frame is replaced by the B-roll (hard cut, no transition). The 16:9source is scaled to COVER and SUBJECT-cropped to 1080×1920 — full-bleed, neverletterboxed (same philosophy as fill-vertical). The crop offset on the slackaxis follows the cutaway's subject (a face if present, else a person, else thethresholded multi-frame saliency mass), so the subject reads centered instead ofsliced off to one side. The podcast audio stayscontinuous for the whole clip; B-roll audio is dropped. No transition SFX bydefault — audio stays pure stream-copy. `BROLL_SFX=1` re-enables a 0.3ssynthesized whoosh (make_whoosh.py, ~-15dBFS under speech) that sweeps up intoeach cutaway and down out of it. Runs BEFOREburn-subtitles so karaoke captions render on top of the cutaways.## Invoke```.claude/skills/broll-composite/broll-composite.sh <in_clip.mp4> <broll_plan.json> <out.mp4>```- `in_clip`: the vertical 1080×1920 clip (from fill-vertical)- `broll_plan.json`: from broll-pick- `out`: composited clip## Behavior- Zero picks, or every `clip_path` missing → copy-passthrough, exit 0.- A pick whose `clip_path` no longer exists is skipped; remaining picks apply.- ffmpeg failure → falls back to passthrough (never blocks the pipeline).## IdempotencyCaches on in_clip+plan mtimes + BROLL_SFX via `<out>.compmeta`.## Notes- Subject-cover crop reuses fill-vertical's framing engine (`build_filter.py` imports `fill_vertical` for face/pose detection): per cutaway it samples 5 frames and picks the slack-axis offset face -> person -> thresholded multi-frame saliency. Still COVER (no extra punch-in) — only WHERE the crop sits changes. Degrades to a centered crop when MediaPipe/cv2 are unavailable.- Whole video is re-encoded (overlay can't partial stream-copy); audio is amix'd with the whoosh bed to AAC 192k (or `-c:a copy` when BROLL_SFX=0 / no picks). Uses `_lib/encode.sh` (VideoToolbox/x264) + thread caps.

Frequently asked questions