puntorigen/avatar-skills / broll-core
broll-core
VerifiedInternal 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 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. |
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, matchingavatar-reel-composer. - Output: clips are
NNN_<slug>.mp4(zero-padded, auto-incremented vianext_index) and each run appends an entry tomanifest.json({"clips": [...]}), a drop-in foravatar-reel-composer(broll_source: "existing"). - Avatar PiP: by default (
length="avatar") the avatar carries audio and drives length; the base loops to cover it. Withlength="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-forwardpipshot (avatar-camera-angles --move pip) lip-synced locked withp-video-avatar.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |