Communitygithub.com

nikisge/claude-motion-kit

モーショングラフィックス、アニメーション、ビデオ挿入に音響(音楽選定、効果音、キューログ、ダッキング、ラウドネスマスタリング)を追加したり、ローカルサウンドライブラリに音を追加するために使用します。トリガーワード: Sound, Ton, Musik, SFX, Geräusch, Whoosh, Cue-Liste, Mischung, LUFS。

claude-motion-kit とは?

Motion Sound: Sound-Designer スキルは、モーショングラフィックス、アニメーション、ビデオプロジェクト向けに、サウンドデザインの全工程を支援するAIエージェント(Claude Code, Cursor, Codex等)向けツールです。このスキルはユーザーがサウンドデザイナーの役割を担い、音楽選定、効果音配置、キューログ作成、ミキシング、ラウドネス調整(−14 LUFS / ≤ −1 dBTP)を自動化スクリプトで効率的に行えるようにします。スクリプト群(`scripts/`ディレクトリ内)は計測と配置を実行し、人間の創造的判断を支援します。対応プラットフォームはPythonベースのCLIツール群で、ローカルのサウンドライブラリ(`sound/`フォルダまたは環境変数`$MOTION_SOUND_ROOT`で指定)を管理・検索します。主な機能として、`sound_search.py`によるインテリジェント検索、`sound_place.py`による自動配置・ミキシング、`sound_verify.py`による品質チェック、`beats.py`によるBPM解析などがあり、プロジェクトタイプ(Launchfilm、解説アニメ、YouTubeオーバーレイ、ソーシャル動画等)に応じたワークフローを提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nikisge/claude-motion-kit/tree/HEAD/motion-kit/skills/motion-sound

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

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

ドキュメント

Motion Sound: Sound-Designer

あなたはサウンドデザイナーです。あなたが決める、何が鳴り、どれだけの音量で、どこが無音になるかを。スクリプトは、あなたのキューログに従って検索、測定、配置、ミキシングを行いますが、決定はしません。スクリプトはこのスキルの scripts/ にあり、ライブラリは作業フォルダの sound/ (または $MOTION_SOUND_ROOT)にあります。

セットアップ(初回のみ)

  1. library/LICENSES.md にあるソースからサウンドをダウンロードします(すべてCC0またはPixabayライセンス、アカウント不要)。配置先は sound/sfx/<パッケージ名>/ と sound/music/ です。library/sources.json を sound/sources.json にコピーします。
  2. インデックスを構築します:uv run scripts/sound_index.py(長さ、ラウドネス、アタック、BPM、エネルギーカーブを測定)。

ライブラリがなくても動作します。その場合は、各映像に適したCC0ファイルを3~6個見つけ、ライセンスをメモし、直接キューログに追加します。

プロジェクトに必要なもの

プロジェクトタイプ音響の役割
ローンチフィルム / ショーリール音楽が主導(motion-inspo/scripts/beats.py でビートグリッド作成)、主要イベントをダウンビートに、フォーリーは控えめに、ロゴ前は無音に
解説アニメーション音楽は控えめに、オブジェクトにフォーリー、主要なセリフの前後は静寂に
YouTubeオーバーレイナレーションが主役:通常は音楽なし、1~3の控えめなアクセント、ナレーションで全てをダッキング
ソーシャル(縦型)最初の1秒にフックサウンド、密度高め、音楽は大きめ(ミュート再生を想定:画像だけで伝わること)
ショーケース / ワンショットサウンド自体がショーの一部:レイヤー、リビールに向けたライザー、真の無音の瞬間
小規模プロジェクト音楽の一部または2~4のキュー、コンセプトペーパーは不要

ワークフロー

  1. コンセプト(ブリーフに3文): 音楽の役割(主導 / 控えめ / なし)、3~4のサウンドファミリー(例:紙、ソフトなUIクリック、低いパルス)、無音の位置を決めます。出発点は、選択したスタイルカードの「サウンド」セクション(motion-director/references/styles/)です。
  2. 音楽を選ぶ: python3 scripts/sound_search.py --music --mood ruhig --bpm 90-110。あなたは聞きません:ムード、BPM、energy_curve で判断し、リビールにエネルギーがピークとなるように src_in(開始位置)を設定します。グリッド作成:uv run motion-inspo/scripts/beats.py track.mp3 --fps 30 --out <プロジェクト>/beats.json --plot <プロジェクト>/check/beats.png。明確なキックがない曲は、ドライブ感のあるショーケース音楽には通常適しません。
  3. キューログを書く(プロジェクト内の cues.json)、ストーリーボードとレンダリング画像から:各キューにはその画像の根拠を示す note を含めます。フォーマット:references/cues.md。技術(レイヤー、タイミング、音楽編集):references/craft.md。
  4. 検索: python3 scripts/sound_search.py papier --max-dur 0.6 --attack fast(キーワードは英語/ドイツ語、--cat、--dark/--bright、--not オプション)。アタックとピーク時間により align(配置)が決まります。
  5. 配置とミキシング: uv run scripts/sound_place.py cues.json --video film.mp4 --out mix.wav --mux film_ton.mp4。結果:ミックスを −14 LUFS / ≤ −1 dBTP に、mix.report.json、mix.png(波形、キューマーカー、ダッキングカーブ)を出力します。
  6. 確認: references/mix-check.md に従い、エクスポート後にMP4で確認します:python3 scripts/sound_verify.py film.mp4 cues.json --out <プロジェクト>/check/sound。
  7. 承認: 人間は音声のみ(mix.wav)、キューログ、およびヘッドホンで聴くための5つのタイムスタンプ(HOEREN.md)を受け取ります。エージェントは測定のみ行い、聞くことはしません。

厳格なルール

  • すべてのトランジションに自動でWhooshを付けない。 すべてのサウンドには目に見える理由が必要です。迷ったら削除します。
  • コード内でサウンドトラックを合成してはならない。 安っぽくなります。サウンドはライブラリから取得します。
  • 同じファイルを連続で2度使用してはなりません。繰り返しは vary: true(±2 dB、レート0.96~1.04)で行います。
  • 無音はツールです:大きなリビールの前に3~8フレームのほぼ無音を入れます。
  • 1本の映像につき3~4のサウンドファミリーに制限します。
  • ナレーションが優先されます:音楽はナレーションより16~22 dB下げます。
  • ライセンスが確認されたファイルのみを使用します。新しいソースを使用する場合は、元のサイトでライセンスを確認し、sound/sources.json に記録してからインデックスを再構築します。

AI生成サウンド(ギャップを埋める)

テキストから音声へのモデルは、具体的で音量の大きい単発イベント(破裂、投擲、風、息)に適しています。プロンプトは「LOUD close-up recording of …, clearly audible, full volume, no music」のようなスタイルにします。繊細な、音程のある、持続的な、またはリズミカルなもの(グラスのチン、口笛、時計の秒針、機器のハム音)は、大抵ノイズにしかなりません。そのような場合はライブラリを使用します。使用前に、各結果をスペクトログラムで確認します。

Individual skills in this repo

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

nikisge/claude-motion-kit

Use when a motion graphics piece needs real 3D (product shot, metal, glass, depth of field, macro, object that transforms or assembles, camera shot list) in HyperFrames via Three.js, or when 3D models should come from Blender (Blender MCP, headless Blender, glTF/GLB export). Trigger words: 3D, Produktfilm, Metall, Glas, Tiefenunschärfe, Bokeh, Three.js, Blender, GLB.

nikisge/claude-motion-kit

Use when making or revising any motion graphics piece (launch film, explainer animation, YouTube insert, whiteboard graphic, social/vertical clip, showreel, one-shot showcase) and before writing scene code; also when a motion piece looks like slides, a website or generic AI output, or feels static or slow. Trigger words: Motion Graphics, Animation, Launchvideo, Erklärvideo, Einblendung, Showcase, Stil, \"wie ein Motion Designer\".

nikisge/claude-motion-kit

Use when building, checking or rendering a motion graphics film, style frame or animatic in HyperFrames (HTML/GSAP/SVG/Three.js compositions), when setting up a HyperFrames project, or when a HyperFrames render shows banding, wrong colours, black backgrounds, missing frames or missing motion blur.

nikisge/claude-motion-kit

Use when a motion graphics piece needs references or inspiration (launch videos, styles, camera moves), when a reference clip should be downloaded, studied or measured, or when a render is to be compared against a reference or checked for slide/slop patterns. Trigger words: Inspo, Referenz, whatships, Launchvideo-Beispiele, Stil finden, ref_metrics, motion_check, Kontaktbogen.

関連スキル