Communitygithub.com

字幕オーバーレイドクトリン

埋め込み字幕ワークフローのためのオーバーレイドクトリン — キャプションモデル(ドロップ/レール/エンベッド)と、キャプションは映像の上にオーバーレイとして合成され、コンテンツを避けるために下部を確保してはならないというルールを定義します。

字幕オーバーレイドクトリン とは?

このスキルは、`embedded-captions` スキルを補完するオーバーレイドクトリンを提供します。キャプションの表示方法を「ドロップ(非表示)」「レール(デフォルト字幕)」「エンベッド(演出強調)」の3つに分類し、エンベッドは限定的に使用すべき(1ビートに最大1つ、隣接配置禁止)と定めます。同時に、キャプション行は映像の上にオーバーレイとして合成され、コンテンツを避けるための下部予約帯(キープアウトバンド)を設けてはならないという原則を強制します。これにより、構図は常に真の垂直中央を基準とし、映像は全フレームを活用できます。主にトーキングヘッド動画や製品ローンチ動画のキャプション・字幕設計時に適用され、内容の可読性は機械的なゲートではなく視覚的な判断で評価します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

字幕オーバーレイドクトリン は何をしますか?

オーバーレイドクトリン — 上位スキル embedded-captions を補完します。上位スキルに組み込まれているとは期待しないでください。上位スキルの上に適用します。

ここでは2つの考え方を組み合わせます。1つ目はキャプションモデル — 発話された各フレーズは drop、rail、embed のいずれかであり、embed は稀にしか使えない獲得すべき山頂であり、デフォルトではありません。2つ目はオーバーレイ則 — キャプション行は映像の上にオーバーレイとして合成されます。予約ゾーンではないため、コンテンツを上にずらしたり「空ける」ために下部にデッドバンドを残すことは決してありません。この2つは互いに強化し合います。キャプションはオーバーレイとして乗る(レールは前面、稀にエンベッドは被写体の背後)ため、構図はフルフレームを維持し、真の垂直中央にセンタリングされます。

キャプションモデル — drop / rail / embed

発話された各フレーズは3つのいずれかです(embedded-captions からの引用):

内容表示方法
dropフィラー — えーと/あの、どもり、言い直し表示しない
railデフォルト — 通常の発話内容(逐語)クリーンな lower-third 字幕、前面に、可読。パンチワードにはインライン 強調 ハイライト(アクセントカラー / アクティブワードポップ)を付けてもよい — それはレールに留まる。
embed昇格された山頂 — 見出しとなるビート被写体の背後に合成される1つの大きな単語(マットオクルージョン)、デザインされた入場+退場

レールがほとんどのテキストを担い、embed は稀にしか使えない獲得すべき山頂です — ビートあたり≤1、隣接または同時表示不可、ビート間≥1間隔。短いクリップ → 通常1つのembed。長い解説 → セクションあたり約1つ。すべての単語をembedにするのがよくある間違いです。

これが標準モードの形状です(rail = 逐語 lower-third、embed = 被写体背後に合成されるクライマックス)。シネマティックモードはレールを廃し、すべてをembedスタイルにします — 純粋に映画的な要求にのみ使用し、単語を読ませる必要がある解説/ボイスオーバーには決して使用しないでください。

レール優先、embed は稀少(負荷のかかるルール)

embedded-captions の譲歩不能条件からの引用:

  • トーキングヘッド/解説ではレール優先。 全トランスクリプトをembedにしないでください — ほとんどのテキストはレールです。embed は山頂のみ。すべてをembedにするのがデフォルトの間違いです。
  • embed は稀少 + 間隔を空ける。 文/ビートあたり≤1のembed、隣接または同時表示不可、ビート間≥1間隔、最大1つの apex。climax = ビートごとの山頂であり、「クリップ全体のただ一つの見せ場」ではありません。

オーバーレイ則 — キャプションは予約帯ではない

生成されたローンチコンポジションでキャプションが有効な場合、finalize は小さく最小限の単語単位のキャプション行を、映像全体の上にオーバーレイレイヤーとして合成します(1行テキスト、下部中央揃え、キャンバス高さの約5〜8%)。これはオーバーレイであり、予約ゾーンではありません(製品ローンチビデオシーンエージェントの制約#13からの引用):

  • コンポジションを真の垂直中央、y = H / 2 にセンタリングする(横長540、縦長960)。キャプションの「場所を空ける」ためにコンテンツを上にずらさないでください。0.42 × H にセンタリングされ下部にデッドバンドがあるコンポジションはバグであり、修正ではありません。
  • コンテンツはキャンバスの下端まで広がってかまいません。フルブリードの被写体、レール、背景もすべて歓迎します。
  • 1つのソフトな礼儀ルール: キャプション行が置かれる下部約80pxの中央スパンに、重要な小さな可読テキスト(URL行、法務行、サブキャプション)を配置するのは避けてください — オーバーレイが干渉します。キャプションの下の大きな画像/カード/アンビエントコンテンツは問題ありません。キャプションスキンはコンテンツの上で読めるように設計されています。
  • 機械的なキープアウトゲートはありません(古い captions.mjs keepout チェックは廃止されました)。finalize のスナップショットQAは、キャプションとコンテンツの重なりにおける可読性を視覚的に判断します。

キャプションが無効の場合: 同じ配置の自由 — オーバーレイが単に存在しないだけです。

これら2つのルールが1つのドクトリンである理由

モデルは、レールは前面に乗り、embed は被写体の背後に合成される稀な単語であると述べています — どちらもそのまま出荷される映像に追加されるレイヤーです。オーバーレイ則は、キャプション行は映像全体の上に合成されるレイヤーであり、レイアウトから切り出された帯ではないと述べています。したがって、キャプショニングパイプラインとローンチビデオパイプラインの両方において、キャプションは予約するゾーンではなく、追加するオーバーレイです:

  • フルフレームを維持し、真の中央にセンタリングし、コンテンツを端まで広げます。
  • レール(または小さなオーバーレイキャプション行)に逐語の単語を担わせます。
  • 真の山頂でのみ単語をembedに昇格します — 稀少、間隔を空け、決して同時に2つは使用しません。
  • 何も予約せず、キャプションとコンテンツの重なりにおける可読性を、キープアウトゲートではなく視覚的に判断します。

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

関連スキル