embedded-captions

Adds verbatim or cinematic captions to talking-head videos using transcription and subject matting.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Adding styled captions to existing talking-head footage normally requires manual editing, keyframing, and rotoscoping. This Skill automates the entire pipeline locally: it transcribes speech, segments the subject with a matte, and composites captions into the scene without altering the original footage. ## Core Features & Use Cases - 35-style identity catalog: Pick one visual identity (rail, column-flow, or themed VFX) from CATALOG.md; the engine, compiler, and authoring file are derived automatically. - Rail + embed caption model: A verbatim lower-third rail carries most text while scarce peak words are composited behind the subject via matte occlusion. - Deterministic local pipeline: One prepare script runs matting, Whisper transcription, and safe-zone analysis in parallel, followed by JSON authoring, preview-frame QA, and a gated render to final.mp4. - Use Case: Given a 60-second founder update clip, probe the footage, pick the keynote identity, author a small cinematic.json, preview composite frames, and render a captioned video with the climax word embedded behind the speaker. ## Quick Start Ask the AI to add captions to your talking-head video file using the embedded-captions skill and let it recommend an identity from the catalog.

Frequently Asked Questions about embedded-captions

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

FAQPage Schema
How do I add captions to a talking-head video automatically?▼

Run the prepare script on your project to generate the subject matte, transcript, and safe-zone analysis in parallel, then author a small JSON of creative choices and render. The pipeline composites captions onto the untouched footage and outputs final.mp4.

What caption styles are available for video subtitles?▼

The catalog offers 35 identities across three engines: clean verbatim rails like anchor, cinematic column-flow looks like cream and neon, and themed VFX constitutions like ordnance and terminal. You pick one identity and the engine is derived automatically.

Can captions be placed behind the subject in a video?▼

Yes, embed captions are composited behind the subject using a human segmentation matte, so peak words appear integrated into the scene. Embedding is kept scarce by design; most text stays on a front lower-third rail.

Does the caption workflow work on multi-speaker or multi-shot videos?▼

No, the decision gate refuses clips with multiple speakers, hard cuts, or no clear human subject. Split multi-shot footage into individual shots and render each one separately.

Why do light captions wash out on bright video backgrounds?▼

Screen-blend caption templates fail above roughly 180 luminance. The luminance pre-flight probe detects bright scenes so you pick the ink identity or the opaque anchor rail instead of recoloring a locked template.

Does the skill modify or color-grade the original footage?▼

No, the video ships untouched; captions are the only addition. The single sanctioned exception is Theme mode's plate reaction budget, applied after the matte composite so subject, text, and plate move as one frame.