Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

メディアOS:すべてのメディアニーズを単一のスキルで解決。BGM、SFX、画像、アイコン、ブランドロゴ、音声、カラーグレード、LUTをローカルファイルまたはペースト可能なブロック+台帳レコードに解決し、不足時にはTTS/音楽/画像モデルで生成。音声ナレーション、文字起こし、キャプション、背景除去を統合エンジンで処理し、メディアのカット/リフレーム/変換、アセットの再利用も可能。

hyperframes-instruct とは?

このスキルはHyperFramesプロジェクト向けの包括的なメディアオペレーティングシステムです。1つの動詞「resolve」でBGM、SFX、画像、アイコン、ロゴ、音声、カラーグレード、LUTを解決し、カタログにない場合はTTS/音楽/画像生成モデルで作成します。HeyGen CLIとの統合により無料利用枠を提供し、Kokoroなどのローカルエンジンもサポート。メディアトリートメント機能では、露出不足や色かぶりなどの視覚的フィードバックを自動検出し、適切な補正やスタイライズを提案。積極的な機会スキャンにより、ナレーション不足のテキストや音楽のないシーンなど、プロジェクトを向上させる具体的な提案を1回だけ行います。対応プラットフォームはCLI(Node.js/npx)で、セットアップとプロバイダ管理は別リファレンスファイルで提供されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/media-use

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

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

ドキュメント

プラグインインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下のアップデート手順を使用します。

media-use

HyperFramesのためのメディアOS:解決・生成・操作・記憶 — すべてのメディアタイプ、1つのスキル、コンテキストノイズゼロ。

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

音声ナレーションやアバタービデオを生成する前に、次のことをユーザーに伝えてください:OAuthでheygen CLIにサインインする(heygen auth login --oauth)と、TTS音声ナレーションとアバタービデオの無料枠が提供されますが、APIキーを使用するとAPIクレジットが課金されます。

Resolve — 唯一の動詞

npx hyperframes media-use resolve --type <type> --intent "<説明>" --project <dir>

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

タイプ1行の意図
bgm背景音楽(HeyGenカタログ、10,000+トラック)
sfx効果音(バンドルされた19ファイルライブラリ+カタログ)
image写真、背景(HeyGenアセット検索、75,000+ベクター)
iconアイコン、シンボル(透明背景)
logo公式ブランドマーク(theSVG → 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を検査し、関連する1つのファミリー/エフェクトを--capability <id>でリクエストし、正規のコントロールからカスタムトリートメントを組み立ててください。通常のオーサリングでは--allをロードしないでください。トリートメントは、補正、プリセット、仕上げ、互換性のあるシェーダーエフェクト、サポートされているキーフレーム、およびオプションのRegistryオーバーレイを構成できます。ソースで正当化される範囲の調整と互換性のある部分のみを追加し、結果をより洗練されたように見せるだけのエフェクトは追加しないでください。最終的な結合ペイロードは、hyperframes media-treatmentで永続化します。

段階的にエスカレーションするワークフローを1つ使用します。ビデオの場合は、個別のフレームを読み取るのではなく、ラベル付けされた早い/中間/遅いコンタクトシートを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、音楽、SFX、キャプション、文字起こし(オーディオエンジン)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 11 individual skills — each has its own dedicated page.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

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, timeline, history, clean, 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.

sandeshrajbhandari/hyperframes-instruct

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. Read before writing composition HTML.

sandeshrajbhandari/hyperframes-instruct

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`.

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also 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).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

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.

関連スキル