talking-head-recut

Overlay timed graphic cards onto talking-head videos synced to transcripts and render to MP4.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/Sergiotsk/Interstellar --skill talking-head-recut-sergiotsk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: talking-head-recut
Source: https://github.com/Sergiotsk/Interstellar/tree/main/.agents/skills/talking-head-recut
Command: npx skills add https://github.com/Sergiotsk/Interstellar --skill talking-head-recut-sergiotsk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires hyperframes, gsap, and includes references (resource) and assets (resource) components.

What problem does it solve? Raw talking-head, interview, or podcast footage lacks visual structure; this Skill layers designed, timed graphic overlays (titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture) onto the untouched clip, synced to what is actually being said. ## Core Features & Use Cases - Transcript-driven card design: Extracts audio with ffmpeg, transcribes locally via Whisper (hyperframes transcribe), and derives card timing from word-level timestamps. - Visual design library: Ships 10 card styles, 4 layouts, and 3 video frames as self-contained HTML references, mixable across 16:9, 9:16, and 4:5 canvases. - GSAP composition rendering: Assembles per-card HTML fragments into one composition and renders to MP4 via the hyperframes CLI, with no third-party API keys. - Use Case: Take a 2-minute interview clip, auto-infer roughly 17 cards from its information density, pick a portrait 9:16 canvas with a stack layout, and produce a social-ready video with kinetic titles and data callouts. ## Quick Start Package my interview clip videos/interview.mp4 with graphic overlay cards and render it as a 9:16 portrait MP4.

Frequently Asked Questions about talking-head-recut

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add graphic overlays to a talking-head video?▼

Provide a local video file; the workflow extracts audio with ffmpeg, transcribes it with local Whisper, designs timed HTML cards from the transcript, and renders the assembled GSAP composition to MP4 via the hyperframes CLI. The original clip plays untouched underneath the overlays.

What is the difference between graphic overlays and embedded captions?▼

Embedded captions render the spoken words as readable subtitles, while graphic overlays add designed cards such as titles, lower-thirds, data callouts, and quotes on top of the playing video. Use the embedded-captions skill for plain subtitles and this one for designed graphics.

Does video transcription require an API key or external service?▼

No. Transcription runs locally through Whisper via the hyperframes transcribe command, so there is no third-party service, API key, or rate-limited proxy involved. Only system ffmpeg and ffprobe are required alongside the CLI.

What aspect ratios and layouts are supported for output video?▼

Three canvas ratios are supported: 16:9 (1920x1080), 9:16 (1080x1920), and 4:5 (1080x1350). Four layouts control how video and cards share the canvas: split, stack, picture-in-picture, and full-screen overlay.

How many overlay cards should a video have?▼

Card count is inferred from video duration and transcript information density, with a minimum floor of 5 cards and no upper limit. A 2-minute data-dense clip yields roughly 17 cards, while a 1-hour low-density podcast yields around 53.

Why does the rendered video show a black tail at the end?▼

Whisper can return the final word's end timestamp slightly past the actual clip duration. Clamp every card endSec and the composition durationSeconds to the duration reported in metadata.json to prevent the black tail.