How do I install the Broll Core skill?

Run npx skillmds@latest add puntorigen/broll-core 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 Core 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 Core?

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 Core free to use?

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

Who published Broll Core?

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

Broll Core by puntorigen — Agent Skill

Name: Broll Core
Author: puntorigen

Broll Core

Internal shared library for the broll-* B-roll skills (broll-web-capture, broll-browser-recorder, broll-terminal, broll-demo-avatar). Provides the canonical reel geometry/fps that match avatar-reel-composer, thin ffmpeg/ffprobe wrappers, the numbered-clip + manifest.json conventions, and the avatar picture-in-picture (PiP) compositor (pip_overlay, avatar- or base-driven). NOT invoked directly — it is imported by the other broll-* skills. Do not run this skill to make content; use broll-web-capture or broll-terminal.

puntorigen 6d726ac 4 files · 15.3 KB Updated Sep 17, 2026

File contents

broll-core (shared library)

Single source of truth for the broll-* family so the base-layer skills produce interchangeable output and the avatar-PiP compositor lives in exactly one place (DRY). It is a library, not a user-facing skill — you never invoke it directly.

What's here (`scripts/`)

Module What

_common.py Canonical ASPECTS (9:16 = 1080×1920) + DEFAULT_FPS=30, run/ffprobe_* wrappers, next_index + append_manifest (numbered clips + manifest.json), find_font. Set C.PREFIX per skill for nicer logs.

pip_overlay.py overlay_pip(base, avatar, ..., length=) — composites the talking avatar in a PiP circle (default) or split layout over any base clip. length="avatar" (default): avatar audio drives length, base loops. length="base": the base drives length (e.g. a recorded demo), avatar freezes at its narration end. Used by every base-layer skill's --avatar shortcut, by broll-browser-recorder (base-driven) and by broll-demo-avatar.

Module	What
`_common.py`	Canonical `ASPECTS` (9:16 = 1080×1920) + `DEFAULT_FPS=30`, `run`/`ffprobe_*` wrappers, `next_index` + `append_manifest` (numbered clips + `manifest.json`), `find_font`. Set `C.PREFIX` per skill for nicer logs.
`pip_overlay.py`	`overlay_pip(base, avatar, ..., length=)` — composites the talking avatar in a PiP circle (default) or split layout over any base clip. `length="avatar"` (default): avatar audio drives length, base loops. `length="base"`: the base drives length (e.g. a recorded demo), avatar freezes at its narration end. Used by every base-layer skill's `--avatar` shortcut, by `broll-browser-recorder` (base-driven) and by `broll-demo-avatar`.

Who uses it

broll-web-capture ──────┐
broll-browser-recorder ─┤
broll-terminal ─────────┼─► broll-core  (geometry, ffmpeg, manifest, PiP compositor)
broll-demo-avatar ──────┘

How skills import it

Each consumer adds broll-core/scripts to sys.path (resolved relative to the skill, assuming the sibling .cursor/skills/<skill>/scripts/ layout) and then import _common as C / import pip_overlay as PIP. If broll-core is missing, the consumer fails fast with an install hint.

Setup

pip3 install -r .cursor/skills/broll-core/scripts/requirements.txt

ffmpeg + ffprobe must be on PATH. This library has no other runtime deps.

Conventions (keep these stable — other skills depend on them)

Geometry: outputs use ASPECTS; 9:16 is 1080×1920 at 30fps, matching avatar-reel-composer.
Output: clips are NNN_<slug>.mp4 (zero-padded, auto-incremented via next_index) and each run appends an entry to manifest.json ({"clips": [...]}), a drop-in for avatar-reel-composer (broll_source: "existing").
Avatar PiP: by default (length="avatar") the avatar carries audio and drives length; the base loops to cover it. With length="base" the base drives length (a recorded demo is the hero) and the avatar freezes on its last frame once its narration ends. Either way the avatar clip should be a static, face-forward pip shot (avatar-camera-angles --move pip) lip-synced locked with p-video-avatar.

---name: broll-coredescription: Internal shared library for the broll-* B-roll skills (broll-web-capture, broll-browser-recorder, broll-terminal, broll-demo-avatar). Provides the canonical reel geometry/fps that match avatar-reel-composer, thin ffmpeg/ffprobe wrappers, the numbered-clip + manifest.json conventions, and the avatar picture-in-picture (PiP) compositor (pip_overlay, avatar- or base-driven). NOT invoked directly — it is imported by the other broll-* skills. Do not run this skill to make content; use broll-web-capture or broll-terminal.---# broll-core (shared library)Single source of truth for the `broll-*` family so the base-layer skills produce**interchangeable** output and the avatar-PiP compositor lives in exactly oneplace (DRY). It is a library, not a user-facing skill — you never invoke itdirectly.## What's here (`scripts/`)| Module | What ||---|---|| `_common.py` | Canonical `ASPECTS` (9:16 = 1080×1920) + `DEFAULT_FPS=30`, `run`/`ffprobe_*` wrappers, `next_index` + `append_manifest` (numbered clips + `manifest.json`), `find_font`. Set `C.PREFIX` per skill for nicer logs. || `pip_overlay.py` | `overlay_pip(base, avatar, ..., length=)` — composites the talking avatar in a PiP circle (default) or split layout over any base clip. `length="avatar"` (default): avatar audio drives length, base loops. `length="base"`: the base drives length (e.g. a recorded demo), avatar freezes at its narration end. Used by every base-layer skill's `--avatar` shortcut, by `broll-browser-recorder` (base-driven) and by `broll-demo-avatar`. |## Who uses it```broll-web-capture ──────┐broll-browser-recorder ─┤broll-terminal ─────────┼─► broll-core (geometry, ffmpeg, manifest, PiP compositor)broll-demo-avatar ──────┘```## How skills import itEach consumer adds `broll-core/scripts` to `sys.path` (resolved relative to theskill, assuming the sibling `.cursor/skills/<skill>/scripts/` layout) and then`import _common as C` / `import pip_overlay as PIP`. If `broll-core` is missing,the consumer fails fast with an install hint.## Setup```bashpip3 install -r .cursor/skills/broll-core/scripts/requirements.txt````ffmpeg` + `ffprobe` must be on PATH. This library has no other runtime deps.## Conventions (keep these stable — other skills depend on them)- **Geometry:** outputs use `ASPECTS`; 9:16 is **1080×1920** at **30fps**, matching `avatar-reel-composer`.- **Output:** clips are `NNN_<slug>.mp4` (zero-padded, auto-incremented via `next_index`) and each run appends an entry to `manifest.json` (`{"clips": [...]}`), a drop-in for `avatar-reel-composer` (`broll_source: "existing"`).- **Avatar PiP:** by default (`length="avatar"`) the avatar carries audio and drives length; the base loops to cover it. With `length="base"` the base drives length (a recorded demo is the hero) and the avatar freezes on its last frame once its narration ends. Either way the avatar clip should be a static, face-forward `pip` shot (`avatar-camera-angles --move pip`) lip-synced locked with `p-video-avatar`.

Frequently asked questions