# Captions Overlay

Sets the rules for placing captions as an overlay on top of HyperFrames videos.

- Repository: https://github.com/heygen-com/hyperframes (77062 stars)
- Category: Media
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add heygen-com/hyperframes --skill captions-overlay -g -a claude-code -y`
Codex: `npx skills add heygen-com/hyperframes --skill captions-overlay -g -a codex -y`
Cursor: `npx skills add heygen-com/hyperframes --skill captions-overlay -g -a cursor -y`
Gemini CLI: `npx skills add heygen-com/hyperframes --skill captions-overlay -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add heygen-com/hyperframes`

## Description

Overlay doctrine for captions in HyperFrames videos, the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Applies ON TOP of the `/hyperframes` skill's references/captions.md.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Captions Overlay Doctrine

> **Overlay doctrine, supplements the upstream `/hyperframes` skill's `references/captions.md`. Applies ON TOP of it; do not expect it folded into the upstream skill.**

Two ideas combine here. First, the **caption model**, every spoken phrase is `drop`,
`rail`, or `embed`, and embed is the scarce earned peak, not the default. Second, the
**overlay law**, a caption line is composited ON TOP of the film as an overlay; it is
NOT a reserved zone, so you never shift content up or leave a dead band to "make room"
for it. The two reinforce each other: because captions ride as an overlay (the verbatim
rail in front, the occasional embed behind the subject), the composition keeps its full
frame and centers on the true vertical center.

## The caption model, drop / rail / embed

Every spoken phrase is one of three things:

The rest: https://github.com/heygen-com/hyperframes/blob/HEAD/.agents/skills/captions-overlay/SKILL.md