Skip to content

puntorigen/avatar-skills / broll-core

broll-core

Verified

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 one place (DRY). It is a library, not a user-facing skill — you never invoke it directly.

What's here (scripts/)

ModuleWhat
_common.pyCanonical 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.pyoverlay_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.
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: 471kUpdated Claude CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall