Communitygithub.com

Drama2557/4RealDigital-Video-Studio

자막 오버레이 원칙 — 삽입 자막 워크플로우에서 캡션 모델(드롭/레일/임베드)과 캡션은 영상 위에 오버레이로 합성되며, 콘텐츠를 밀어 올리기 위해 예약된 하단 영역이 아니라는 규칙을 정의합니다. 말하는 사람(head)이나 런치 영상에 캡션/자막을 추가할 때, 구문을 드롭할지, 그대로 레일로 표시할지, 또는 드문 임베드 클라이맥스로 승격할지 결정할 때, 캡션이 포함될 구성을 설계할 때(이탈 영역을 예약하지 마시오), 또는 캡션 아래에서 진정한 프레임 중앙을 기준으로 구성을 중앙에 배치할 때 적용됩니다. `embedded-captions`의 레일+임베드 모델과 `product-launch-video` 씬 에이전트의 제약 조건 #13(캡션 오버레이, 이탈 영역 폐지)을 인용합니다. `embedded-captions` 위에 적용됩니다.

4RealDigital-Video-Studio란 무엇인가요?

이 스킬은 AI 비디오 에이전트(예: Claude Code, Cursor, Codex)를 위한 캡션 오버레이 원칙을 정의합니다. 핵심은 두 가지입니다. 첫째, **캡션 모델**: 모든 구어체는 '드롭'(필러, 생략), '레일'(일반 자막, 전면에 표시), '임베드'(드문 클라이맥스, 피사체 뒤에 합성) 중 하나로 분류됩니다. 둘째, **오버레이 법칙**: 캡션은 영상 위에 오버레이로 합성되며, 콘텐츠를 밀어 올리기 위한 예약 영역이 아닙니다. 이 두 규칙은 서로를 강화하여, 캡션이 오버레이로 존재하기 때문에 전체 프레임을 유지하고 진정한 수직 중앙에 구성을 배치할 수 있습니다. 이 스킬은 `embedded-captions` 스킬 위에 적용되며, 주로 말하는 사람(head) 영상, 설명 영상, 제품 런치 영상 제작 시 사용됩니다. 개발자와 AI 에이전트 사용자는 이 스킬을 통해 자막 레이아웃의 오류(예: 콘텐츠를 밀어 올리거나 모든 단어를 임베드하는 실수)를 방지하고, 시각적으로 깔끔하고 전문적인 캡션 구성을 자동화할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Drama2557/4RealDigital-Video-Studio/tree/HEAD/.agents/skills/captions-overlay

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

캡션 오버레이 원칙

오버레이 원칙 — 상위 스킬 embedded-captions를 보완합니다. 상위 스킬 위에 적용되며, 상위 스킬에 포함된 것으로 간주하지 마십시오.

두 가지 아이디어가 결합됩니다. 첫째, 캡션 모델 — 모든 구어체는 드롭, 레일, 또는 임베드이며, 임베드는 드물게 얻어지는 최고점이지 기본값이 아닙니다. 둘째, 오버레이 법칙 — 캡션 라인은 영화 위에 오버레이로 합성됩니다. 예약된 영역이 아니므로 콘텐츠를 위로 밀거나 '공간을 만들기' 위해 빈 띠를 남기지 않습니다. 두 가지는 서로를 강화합니다: 캡션이 오버레이로 존재하기 때문에(그대로의 레일은 전면에, 드문 임베드는 피사체 뒤에) 구성은 전체 프레임을 유지하고 진정한 수직 중앙에 배치됩니다.

캡션 모델 — 드롭 / 레일 / 임베드

모든 구어체는 세 가지 중 하나입니다(embedded-captions에서 그대로 인용):

설명표시 방법
드롭필러 — 음/어, 더듬음, 자기 수정표시되지 않음
레일기본값 — 일반적인 구어 내용 (그대로)깔끔한 하단 1/3 자막, 전면에, 읽기 쉽게. 강조할 단어는 인라인 강조 하이라이트(액센트 색상 / 활성 단어 팝)를 가질 수 있습니다 — 레일에 유지됩니다.
임베드승격된 최고점 — 헤드라인이 되는 비트피사체 뒤에 합성된 하나의 큰 단어(매트 오클루전), 디자인된 등장 + 퇴장

레일이 대부분의 텍스트를 전달하며, 임베드는 드물고 얻기 힘든 최고점입니다 — 비트당 ≤1개, 인접하거나 동시에 보이지 않으며, 비트 간격 ≥1개. 짧은 클립 → 보통 임베드 하나; 긴 설명 영상 → 섹션당 약 하나. 모든 단어를 임베드하는 것이 흔한 실수입니다.

이것이 표준 모드 형태입니다(레일 = 그대로의 하단 1/3 자막, 임베드 = 피사체 뒤에 합성된 클라이맥스). 시네마틱 모드는 레일을 제거하고 모든 것을 임베드 스타일로 만듭니다 — 순수 시네마틱 요청에만 사용하고, 단어를 반드시 읽어야 하는 설명 영상/내레이터에는 사용하지 마십시오.

레일 우선, 임베드 드물게 (핵심 규칙)

embedded-captions의 불가침 규칙에서 인용:

  • 말하는 사람/설명 영상에서는 레일 우선. 전체 대본을 임베드하지 마십시오 — 대부분의 텍스트는 레일이며, 최고점만 임베드합니다. 모든 것을 임베드하는 것이 기본적인 실수입니다.
  • 임베드는 드물고 간격을 둡니다. 문장/비트당 ≤1개 임베드, 인접하거나 동시에 보이지 않으며, 비트 간격 ≥1개, 최대 하나의 apex. 클라이맥스 = 비트별 최고점, '전체 클립의 단일 페이오프'가 아닙니다.

오버레이 법칙 — 캡션은 예약된 영역이 아닙니다

생성된 런치 구성에서 캡션이 활성화되면, finalize는 작고 최소한의 단어별 캡션 라인을 전체 영화 위에 오버레이 레이어로 합성합니다(단일 텍스트 라인, 하단 중앙, 캔버스 높이의 약 하단 5-8%). 이는 오버레이지 예약된 영역이 아닙니다(product-launch-video 씬 에이전트의 제약 조건 #13에서 그대로 인용):

  • 구성을 진정한 수직 중앙 — y = H / 2 (가로 540, 세로 960)에 중앙 정렬하십시오. 캡션을 위한 '공간'을 만들기 위해 콘텐츠를 위로 밀지 마십시오. 0.42 × H에 중앙 정렬되고 하단에 빈 띠가 있는 구성은 버그이지 해결책이 아닙니다.
  • 콘텐츠는 캔버스 하단까지 확장될 수 있습니다. 전체 프레임에 걸친 피사체, 레일, 배경 모두 허용됩니다.
  • 하나의 소프트 예의 규칙: 중요한 작은 읽기 텍스트(URL 라인, 법적 고지 라인, 서브 캡션)를 캡션 라인이 있는 하단 약 80px 중앙 범위에 정확히 배치하지 마십시오 — 오버레이가 충돌할 수 있습니다. 캡션 아래의 대형 이미지/카드/주변 콘텐츠는 괜찮습니다. 캡션 스킨은 콘텐츠 위에서 읽히도록 설계되었습니다.
  • 기계적 이탈 방지 게이트(이전의 captions.mjs keepout 검사는 폐지됨)는 없습니다. Finalize 스냅샷 QA는 캡션-위-콘텐츠 가독성을 시각적으로 판단합니다.

캡션이 비활성화된 경우: 동일한 포지셔닝 자유 — 오버레이가 단순히 존재하지 않습니다.

이 두 규칙이 하나의 원칙인 이유

모델에 따르면 레일은 전면에 있고 임베드는 피사체 뒤에 합성된 드문 단어입니다 — 둘 다 그대로의 푸티지에 추가되는 레이어입니다. 오버레이 법칙에 따르면 캡션 라인은 전체 영화 위에 합성되는 레이어이지, 레이아웃에서 잘라낸 영역이 아닙니다. 따라서 캡셔닝 파이프라인과 런치 비디오 파이프라인 모두에서 캡션은 예약하는 영역이 아니라 추가하는 오버레이입니다:

  • 전체 프레임을 유지하고, 진정한 중앙에 중앙 정렬하며, 콘텐츠가 가장자리까지 이어지도록 하십시오.
  • 레일(또는 작은 오버레이 캡션 라인)이 그대로의 단어를 전달하게 하십시오.
  • 진정한 최고점에서만 단어를 임베드로 승격하십시오 — 드물게, 간격을 두고, 절대 두 개가 동시에 오지 않게.
  • 아무것도 예약하지 마십시오. 캡션-위-콘텐츠의 가독성을 이탈 방지 게이트가 아닌 시각적으로 판단하십시오.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Drama2557/4RealDigital-Video-Studio

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

Drama2557/4RealDigital-Video-Studio

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

Drama2557/4RealDigital-Video-Studio

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Drama2557/4RealDigital-Video-Studio

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

Drama2557/4RealDigital-Video-Studio

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Drama2557/4RealDigital-Video-Studio

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

Drama2557/4RealDigital-Video-Studio

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

Drama2557/4RealDigital-Video-Studio

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Drama2557/4RealDigital-Video-Studio

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Drama2557/4RealDigital-Video-Studio

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

Drama2557/4RealDigital-Video-Studio

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

Drama2557/4RealDigital-Video-Studio

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.

Drama2557/4RealDigital-Video-Studio

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

Drama2557/4RealDigital-Video-Studio

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Agent skill / project related to launch or product demo video: Drama2557/4RealDigital-Video-Studio

관련 스킬