media-use

HyperFrames の動画に素材が要るときに読ませるスキルです。音楽・効果音・画像・アイコン・ロゴ・語り・話す人物の動画・字起こし・切り抜き・色調まで、全部ここが担当します。

素材は必ずプロジェクトの assets/ に手元のファイルとして置かれ、台帳に記録されます。描き出しのときに外へ取りに行くことはありません。

HeyGen と無料の道を並べた表

9 行

同梱ファイル（2026-10-22 時点）

115 件

同梱の効果音（オフラインで使える）

21 件

SKILL.md の大きさ（2026-10-22 時点）

5,120 バイト

動詞は resolve だけ

素材を見つけるのも作るのも、1 つのコマンドです。

npx hyperframes media-use resolve --type <種類> --intent "<欲しいもの>" --project <場所>

返ってくるのは resolved <id> → <経路> (<種類>, <情報>) の 1 行だけです。候補や点数などの探索の記録はディスクに残り、会話に持ち込みません（スキルを入れすぎて重くなる仕組み）。

先に使い回せるものを見る

新しく取る前に、--candidates で使い回せる素材を一覧にし、合うかはエージェント自身が判断します。

ただしロゴのようなブランドの素材は注意が要ります。作品をまたいだ置き場から別の顧客のマークが候補に出ることがあるので、銘柄が完全に一致するときだけ使い回せ、と references/resolve.md にあります。

HeyGen の道と無料の道

本文の中心は、必要ごとに 2 つの道を並べた表です。

表はほかに字起こし・切り抜き・色調の 3 行があり、全部で 9 行です（2026-10-22 時点）。字起こしと色調は手元の道だけ、切り抜きは両方に道があります。

HeyGen で作れるもの

heygen の CLI は、resolve のほかにも動画を作れます。文章からの動画、録音に合わせたアバターの動画、声の複製、吹き替え、翻訳した動画、長い動画からの短い切り出しです。手順は references/operations.md にあります。

映像の見え方への注文も受ける

説明文は、映像が暗い・平たい・退屈だ、という感想にもこのスキルを使え、と書いています。レトロや印刷の風合いにしたい、顔を隠したい、見せ方を工夫したい、も同じです。

進め方は慎重です。実際の <img> や <video> を調べ、狙いを 1 つ決め、npx hyperframes media-treatment --capabilities --json から始めます。--all で全部当てるのは禁じられ、CSS や SVG の代用も認めていません。

置いた音の混ぜ合わせ

置いた音のフェード・音量・ダッキング・効果は references/mixing.md の担当です。試写と描き出しは同じ Web Audio の経路を通るので、試写で聞こえる音がそのまま描き出される、と書かれています。

このミックスの手引きは、2026-10-21 に公開元が廃止した hyperframes-audio から移ってきたものです。

HyperFrames 以外で使うとき

素材を HyperFrames のプロジェクトの assets/ に置き、台帳に記録するところまでが仕事です。ほかの仕組みの動画には向きません。

文字・配置・動きを直したいとき

構成や動きは入口の hyperframes の契約と references の担当です。素材が要らない修正なら、このスキルを読ませる必要はありません。

名前の付いた効果を探すとき

「CRT の走査線」「グリッチ」のような既成の見た目は hyperframes-registry が配っています。こちらは素材そのものを扱います。

費用が出るのは HeyGen の道

HeyGen には heygen auth login --oauth でサインインします。OAuth のサインインは契約のクレジットに無料の枠が付き、API キーで使うと API のクレジットが減る、と本文は書き分けています。

当サイトでは料金を検証していません。条件は HeyGen で確かめてください。

HeyGen が無いと失敗するもの

heygen が無いと、音楽・画像・アイコンの resolve は失敗し、そのことを知らせます。HeyGen が要る依頼で CLI が無いかサインインしていないときは、入れ方とサインインの方法を伝え、無料の道を勧めるか待つ決まりです。

--local-only を付けると、ネットに繋ぐ取り先を全部飛ばします。

ホストのアプリの中で動くとき

アプリが自前の素材の道具を持っているなら、そちらを先に使います。HEYGEN_API_BASE が設定されているときはアプリ側が HeyGen の費用を持つので、CLI もサインインも求めず、断られたらアプリの文言をそのまま伝えて止まります。

FFmpeg は必須、手元のモデルは任意

references/setup-providers.md によると、どの道でも ffmpeg と ffprobe は必須です。HeyGen の CLI は v0.3.0 以上が要ります。手元の音声合成（Kokoro）は Python 3.10 以上と pip install kokoro-onnx soundfile が前提です。

提案は 1 回だけ、黙って足さない

作品を組む・見直すときに、語りの無い画面の文字、絵文字のアイコン、仮の画像、無音の切り替え、10 秒以上の無音楽、色かぶりを 1 回だけ洗い出します。直し方はまとめて 1 回だけ聞き、根拠が無ければ提案しない、「そのままで」と言われたら従う決まりです。

効果音のクレジットと素材の権利

CC BY の効果音を使ったら、作者の表示が要ると書かれています（audio/references/sfx.md）。目録や生成の素材も、このスキルが利用条件を保証するわけではありません。ロゴは他社の商標なので、使ってよいかは別に確かめてください。

allowed-tools の指定が無い

allowed-tools の指定はありません。確認なしで走る道具は宣言されておらず、どの道具も利用者の権限の設定どおりに確認されます。

ライセンス

Apache-2.0 です。再配布や商用利用の前に公開元の表記を確認してください。

登録なしで使えますか

使えます。本文の表の「無料」の列は、どれもアカウントが要りません。効果音は Openverse と同梱の 21 件、語りは手元の Kokoro、ロゴは theSVG などから取れます。HeyGen の目録の音楽や画像、HeyGen の声、話す人物の動画を使うときだけ、HeyGen の CLI とサインインが要ります。

費用はかかりますか

無料の道を使う限り、外部の費用は掛かりません。HeyGen は、OAuth でサインインすると契約のクレジットに無料の枠が付き、API キーでは API のクレジットが減る、と本文にあります。エージェントが自分で選んだ有料の呼び出しは、先に確認を取る決まりです。

hyperframes-audio はどこへ行きましたか

2026-10-21 に公開元が廃止し、置いた音のミックスの手引きはこのスキルの references/mixing.md に移りました。フェード・音量・ダッキング・効果は、ここを読ませれば届きます。当サイトの hyperframes-audio の解説は、配布終了の札を付けて残しています。

ロゴは自動で描かれますか

描かれません。取り先は theSVG・GitHub のアバター・ファビコンで、表に「描き直さない」と書かれています。ただし他社の商標を使ってよいかは別の問題なので、掲載の条件を確かめてください。

対応しているエージェントはどれですか

Claude Code と Codex です。公開元の README が、Claude Code へのプラグインの入れ方と Codex へ上げる手順を案内しています（2026-10-22 確認）。当サイトは公開元が明記しているものだけを対応として表示しています（指標の意味と限界）。