loop-bgm
動画やゲーム、配信に使うオリジナルのループBGMがほしいときに使います。テンポ・調・パートごとの演奏をTOMLの設計図に書き、プログラムで音にします。同じ設計図からは常に同じ音ができ、気になる行だけを直せます。楽器音はすべて数式合成なので、音源素材のダウンロードや権利表記は要りません。
既存の録音(mp3など)のカットや編集、外部の音楽生成サービス向けのプロンプト作成、音楽理論だけの質問は扱いません。効果音の切り出しと、鼻歌からのメロディ抽出は未実装です。
導入と前提
hooksを同梱しない単一Skillなので、npx skills addで導入します。
npx skills add https://github.com/yukihito-jokyu/context/tree/main/utils/skills --skill loop-bgm --agent codex claude-code
| 項目 | 内容 |
|---|---|
| 必要なソフト | uv。Pythonとnumpyはuvが自動で用意します |
| 試聴(任意) | ループ再生にはsoxのplay、1周の再生にはafplay(macOS)を使います |
| 作業場所 | カレントフォルダのsongs/に設計図、output/に音源を置きます |
渡す情報
用途と雰囲気を渡します。テンポ、調、小節数、声やナレーションを重ねるかが決まっていれば一緒に伝えます。曖昧な依頼でも、エージェントは用途から妥当な値を決めて作り始めます。
依頼例
loop-bgmを使って、ブラウザゲームのタイトル画面に流す、明るいループBGMを作ってください。8小節で、ナレーションは重ねません。
さっきの曲のテンポを少し速くして、ベースを控えめにしてください。ゲームボーイ風でも書き出してください。
進め方
uvがあることを確かめます。- テンポと調、リズム、ベース、コード、メロディ、アレンジ、ミックスの順に
songs/<曲名>.tomlを書きます。 - 通常版、または
--style gameboyでゲームボーイ風のWAVをoutput/に書き出します。 - 出力された「つなぎ目」と「パート別」の数値を見て、必要なら
gain_dbを直して書き出し直します。 - 数値で確かめた範囲と、聴いて判断してほしい点を分けて報告します。
修正の依頼では、テンポならbpm、楽器なら該当パートのinstrumentというように、該当する行だけを編集します。
成果物の例
ブラウザゲームのタイトル画面向けに、BPM 152・D majorの8小節のループBGMを設計図から作り、通常版とゲームボーイ風のWAVを書き出しました。数式合成の音なので、WAVもそのまま掲載しています。
到達点:通常版とゲームボーイ風のWAVの書き出しと、音量の確認まで。音の試聴は未実施。
実行した依頼
loop-bgmを使って、ブラウザゲームのタイトル画面に流す、明るいループBGMを作ってください。8小節で、ナレーションは重ねません。通常版とゲームボーイ風の両方を書き出してください。音は再生しないでください。
実出力の抜粋
以下は保存した原本の冒頭です。全文は原本から取得できます。
# タイトル画面用ループBGM 実行結果
ブラウザゲームのタイトル画面に流す、明るい8小節ループBGMを作りました。通常版とゲームボーイ風の両方を書き出してあります。音は再生していません。
## 成果物
| 種類 | パス |
| --- | --- |
| 設計図 | `songs/title_screen.toml` |
| 通常版 | `output/title_screen/title_screen.wav`(パート別の音源は `output/title_screen/stems/`) |
| ゲームボーイ風 | `output/title_screen_gameboy/title_screen_gameboy.wav`(チャンネル別の音源は `output/title_screen_gameboy/stems/`) |
| 実行ログ | `render.log` |
## 曲の設計
| 項目 | 内容 |
成果物を取得する
確認した結果
- 通常版・ゲームボーイ風ともに、render.logの「つなぎ目」がOK
- どちらも長さ12.632秒、-16.0 LUFS、リミッターの作用0.00%
- afinfoで48 kHz、16bit、2チャンネルのWAVであることを確認
- 最終の設計図で再度書き出し、両方のWAVのハッシュが一致することを確認
- 通常版は打楽器とコードのgain_dbを上げて、音量の目安に近づくよう調整
- ゲームボーイ風のch2とch3は見本の目安より1.7〜1.9 dB小さいが、gain_dbが効かないため未調整
- 実行者は音を聴けないため、雰囲気・メロディ・つなぎ目の聞こえ方は未確認
確認するポイント
エージェントは音を聴けません。数値で確かめられるのはつなぎ目と音量の目安までなので、雰囲気、メロディ、音色、ループの自然さは実際に聴いて判断します。
納品はWAVのままにします。MP3は前後に無音が付き、ループに隙間ができるためです。つなぎ目が要確認になったときは、波形を後から切らず、曲末と曲頭のパターンを見直します。
正本を読む
詳細な手順と設計図の書式はloop-bgmのSKILL.mdを参照してください。