Communitygithub.com

4RealDigital-Video-Studio

HyperFramesプロジェクト向けオールインワンメディアOS。BGM、効果音、画像、アイコン、ロゴ、ボイス、カラーグレーディング、LUTを解決、生成、編集、管理する単一スキルです。

4RealDigital-Video-Studio とは?

このスキルは、HyperFramesプロジェクトにおけるあらゆるメディアニーズを単一のインターフェースで処理できるように設計された、エージェント向けメディアOSです。「resolve」という統一された動詞を通じて、BGM、効果音、画像、アイコン、ロゴ、ボイスオーバー、カラートリートメント、LUTの検索・解決を実行します。HeyGenのアセットカタログ(10,000以上のBGMトラック、75,000以上のベクター画像など)を活用し、不足する場合はTTSや画像生成モデルによる生成も可能です。また、カット、リフレーム、トランスフォームといったメディア編集操作、音声エンジンによるボイスオーバー・文字起こし・キャプション生成・背景除去、さらにはビジュアルフィードバック(暗い、フラット、退屈、プライバシー保護、レトロ/カムコーダー風など)に対するインテリジェントなメディア処理までカバーします。Claude Code、Cursor、Codexなどの開発エージェントと連携し、プロジェクト全体でアセットを再利用・記憶することで、コンテキストノイズを最小限に抑えながらメディア制作を効率化します。

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

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

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

ドキュメント

media-use

HyperFramesのメディアOS:解決・生成・操作・記憶 — あらゆるメディアタイプ、単一スキル、コンテキストノイズゼロ。

初回実行:heygen CLIをインストールしてサインイン(無料利用パスあり)、その後 node <SKILL_DIR>/scripts/resolve.mjs --doctor で確認してください。セットアップとプロバイダーについては references/setup-providers.md を参照してください。

Resolve — たった一つの動詞

node <SKILL_DIR>/scripts/resolve.mjs --type <type> --intent "<description>" --project <dir>

出力は1行: resolved <id> → <path> (<type>, <metadata>)。検索ノイズはすべてディスク上に留まります。

タイプ1行の意図
bgm背景音楽(HeyGenカタログ、10,000+トラック)
sfx効果音(バンドル19ファイルライブラリ+カタログ)
image写真、背景画像(HeyGenアセット検索、75,000+ベクター)
iconアイコン、シンボル(透明背景)
logo公式ブランドマーク(svgl → simple-icons → GitHubアバター → favicon;再描画はなし)
voiceTTSボイスオーバー(HeyGen無料利用パス;ローカルKokoroも選択可)
grade測定された修正候補;幅広い調整/スタイライズはMedia Treatmentsに従う
lutユーザー提供または明示的に選択された再利用可能な検証済み .cube ファイル

新しく解決する前に、--candidates で再利用可能な候補をリストアップして自分で適合性を判断してください。再利用ルール、全フラグ、取り込み(--from)、採用については references/resolve.md を参照してください。

幅広いビジュアルフィードバックをメディアインテントとして扱う

ユーザーが写真メディアの修正、調整、スタイライズ、隠蔽、強調、または表示を明示的に要求した場合、カラーグレーディングやエフェクトの名称を指定していなくても references/media-treatments.md を読んでください。実際の <img>/<video> を検査し、1つの主要なインテントを選択し、決定論的な永続化と検証を使用してください。オプションのテスト済みシードとして一致するレシピを使用するか、hyperframes media-treatment --capabilities --json で機能を検査し、--capability <id> で関連する1つのファミリー/エフェクトをリクエストし、標準的なコントロールからカスタムトリートメントを組み立ててください。通常のオーサリングでは --all をロードしないでください。トリートメントは、補正、プリセット、仕上げ、互換性のあるシェーダーエフェクト、サポートされているキーフレーム、オプションのRegistryオーバーレイを構成できます。ソースに基づく適切な範囲の調整と互換性のある部分のみを追加し、結果をより洗練されたものに見せるためだけにエフェクトを追加しないでください。最終的な結合ペイロードは hyperframes media-treatment で永続化してください。

段階的に進行する単一のワークフローを使用してください。動画の場合、フレームを個別に読むのではなく、ラベル付けされた初期/中期/後期のコンタクトシートを1つ検査してください。通常の補正や調整には、1つの候補を適用し、後処理シートを1つ検査してください。結果が曖昧、時間的、スタイライズ、LUTベース、HDR/LOG対応、プライベート、またはブランドにとって重大な場合にのみ、個別フレームまたは動的なドラフトエビデンスにエスカレーションしてください。

通常の補正や調整の場合、最終的なトリートメントのプリセット/調整JSONを永続化してください。露出、シャドウ、コントラスト、または暖かさをエンコードするためだけに .cube LUTを生成しないでください。LUTは、ユーザーが提供した場合、または選択したトリートメントが明示的に所有している場合にのみ使用してください。resolve --type grade --for ... --analyze は測定エビデンスであり、選択したトリートメントを生成されたLUTに置き換える許可ではありません。サポートされているビネット、グレイン、ブラー、ピクセレート、カラー、トリートメントエフェクトをCSS/SVGオーバーレイで再作成しないでください。それはStudioコントロールと標準的なプレビュー/レンダリングシェーダーパスをバイパスします。

プロアクティブに — メディア機会パスを実行する

人間は通常、どのメディアが作品を引き立てるかを判断できません。あなたはできます。コンポジションを構築またはレビューするときは、1回 根拠のあるスキャンを行い、1回だけ 提案してください。黙って追加したり、アセットごとにしつこく促したりしないでください。

具体的なシグナルが存在する場合にのみ機会を提案してください:

検出されたシグナル提案
画面上のテキスト / ナレーションのないスクリプトTTSボイスオーバー(オーディオエンジン)
絵文字 または アイコンとしてスタイル設定された <div>実際の icon を解決する
プレースホルダー、小さい、またはアップスケールされたように見える画像より良い image を解決する(および/またはアップスケール — references/operations.md を参照)
ハードなシーンカット / 音のないトランジショントランジション sfx
約10秒以上で音楽がないピースbgm
露出不足/露出超過またはカラーキャストに見える映像補正グレード(hyperframes media-treatment --selector '#hero' --analyze --json で検査)
視覚的に平坦またはトピックから外れているように感じる写真メディア1つの具体的なソースに適したプリセットまたはカスタムトリートメント(意図されたターゲットを指定)
静的に感じられる意味のあるメディアの登場/公開1つのサポートされているシークセーフなトリートメントアニメーション;リクエストがプリセットも正当化しない限り色は保持

これをヘルプであり、ナグウェアにしないルール:根拠があり、一般的ではない(シグナルなし → 提案なし);意見が明確かつ具体的(デフォルトを選択した具体的な修正を提案 — 人間が すべて / 一部 / なし を承認);プロジェクトごとに1回(1つにまとめた提案;「そのままにしておいて」を尊重);表面的に、決して黙って変更しない(特にカラーグレード:提案してプレビュー — グレーワールドの「補正」は意図的な夕日やネオンルックを台無しにします)。

どこを見るか — タスクが必要とするファイルだけを読む

タスク読むファイル
解決 / 再利用 / 採用 / 取り込み、フラグ、カスケード、インベントリreferences/resolve.md
カラーグレーディング、LUT、スマートグレード(--for)、グレード比較references/grading.md
ボイスオーバー / TTS、音楽、効果音、キャプション、文字起こし(オーディオエンジン)references/audio.md
既存メディアのカット / リフレーム / トランスフォーム、正確なエラー拡散、HEVCreferences/operations.md
ソースを考慮したクリエイティブトリートメント、リアルタイムエフェクト、オーバーレイ、公開references/media-treatments.md
インストール + 認証、プロバイダーテーブル、RAM階層、--local-only、--providerreferences/setup-providers.md
記憶された設定 + 凍結されたレシピ(ユーザーメモリ)references/memory.md
所有権マトリックス、使用統計、テレメトリー、プライバシー(メンテナー向け)references/meta.md

Individual skills in this repo

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

Drama2557/4RealDigital-Video-Studio

Overlay doctrine for the embedded-captions workflow — 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. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

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

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

関連スキル