Skip to content

iart-ai/b-roll-skills / skills/talking-head-b-roll

talking-head-b-roll

Verified

Add b-roll motion graphics to a talking-head video. Transcribes the recording with word timings, decides line by line when the speaker is shown, when a graphic is laid over them and when a full-frame graphic covers them, draws each graphic from what is actually said (numbers, comparisons, steps, key words) in JavaScript on a canvas, and renders the finished MP4 with the original sound, plus the b-roll alone with alpha for an editor. Use when someone has a recording of a person talking to camera (a talking head, a spoken explainer, a course lesson, an ad read, a podcast clip) and wants it more engaging to watch, wants b-roll, or wants motion graphics added to it.

FileKindSize
SKILL.mdskill md10.4 KB
scripts/compare-timing.pyscript3.1 KB
scripts/render.mjsscript22.1 KB
scripts/timing.test.mjsscript3.5 KB
scripts/transcribe.mjsscript10.9 KB
templates/b-roll.htmlother12.0 KB

scripts/timing.test.mjs

View on GitHub
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync } from 'node:fs';
import vm from 'node:vm';

const html = readFileSync(new URL('../templates/b-roll.html', import.meta.url), 'utf8');
const script = html.match(/<script>([\s\S]*?)<\/script>/)[1];

function page(fps, lead, captureTiming = true) {
  const drawn = [];
  const state = { globalAlpha: 1, fillText(text) { if (this.globalAlpha > 0) drawn.push(String(text)); } };
  const ctx = new Proxy(state, { get: (o, key) => key in o ? o[key] : key === 'measureText' ? () => ({ width: 10 }) : () => {} });
  const canvas = { getContext: () => ctx };
  const sandbox = {
    window: {}, location: { search: '?render=1' }, URLSearchParams,
    console: { warn() {} },
    document: {
      documentElement: { style: { setProperty() {} } },
      querySelector: () => canvas,
      fonts: { load: async () => [], ready: Promise.resolve() },
    },
  };
  vm.createContext(sandbox);
  vm.runInContext(script.replace('const FPS = 30', `const FPS = ${fps}`)
    .replace('VISUAL_LEAD_FRAMES = 6', `VISUAL_LEAD_FRAMES = ${lead}`), sandbox);
  // Keep the real timing machinery; capture its input instead of drawing placeholder graphics.
  if (captureTiming) vm.runInContext('for (const sc of SCENES) sc.draw = (t, s) => { window.last = {t, ...s}; };', sandbox);
  sandbox.drawn = drawn;
  return sandbox;
}

for (const fps of [25, 30, 60]) {
  test(`graphics advance exactly six frames at ${fps} fps`, () => {
    const baseline = page(fps, 0), early = page(fps, 6);
    const start = 3 * fps;
    early.window.draw(start - 7);
    assert.equal(early.window.last, undefined);
    early.window.draw(start - 6);
    baseline.window.draw(start);
    assert.equal(early.window.last.now, baseline.window.last.now);
    assert.equal(early.window.last.audioNow, (start - 6) / fps);
    assert.equal(baseline.window.last.audioNow, 3);
    early.window.draw(4 * fps - 6);
    baseline.window.draw(4 * fps);
    assert.equal(early.window.last.now, baseline.window.last.now);
    assert.equal(early.window.FRAMES, baseline.window.FRAMES);
    assert.equal(early.window.VIDEO, baseline.window.VIDEO);
    assert.equal(early.window.SCENES[0].from, 3 - 6 / fps);
    assert.equal(early.window.SCENES[0].speechFrom, 3);
    assert.equal(early.window.SCENES[0].speechTo, 7.5);
    early.window.last = undefined;
    early.window.draw(Math.ceil(7.5 * fps) - 6);
    assert.equal(early.window.last, undefined);
  });
}

test('zero lead preserves the original scene times', () => {
  const p = page(25, 0);
  assert.equal(p.window.SCENES[0].from, 3);
  assert.equal(p.window.SCENES[0].to, 7.5);
  p.window.draw(74);
  assert.equal(p.window.last, undefined);
  p.window.draw(75);
  assert.equal(p.window.last.now, 3);
});

for (const fps of [25, 30, 60]) {
  test(`key number is hidden before its word and fully readable on it at ${fps} fps`, () => {
    const p = page(fps, 6, false);
    const anchor = Math.ceil(10.2 * fps);
    p.window.draw(anchor - 1);
    assert(!p.drawn.includes('$10,000'));
    p.drawn.length = 0;
    p.window.draw(anchor);
    assert(p.drawn.includes('$10,000'));
    assert(!p.drawn.some(t => /^\$/.test(t) && t !== '$10,000'));
  });
}

test('withheld keyword can wait for a later reveal within an early scene', () => {
  const p = page(25, 6, false);
  vm.runInContext("SCENES[0].draw = keyword('Answer', 'revealed now', 5.0)", p);
  p.window.draw(124);
  assert(!p.drawn.includes('Answer'));
  p.drawn.length = 0;
  p.window.draw(125);
  assert(p.drawn.includes('Answer'));
});
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall