Communitygithub.com

HyperFrames Audio

トラックのフェードイン/フェードアウト、クロスフェード、ゲイン、ボリュームオートメーション、ダッキング、ボイスオーバーカーブ、エフェクトチェーン、オートメーションエンベロープなど、HyperFrames コンポジション内の既存オーディオのミキシングに使用します。

HyperFrames Audio とは?

HyperFrames Audioは、HyperFramesコンポジション内のオーディオミキシングを専門に行うスキルです。単なるエフェクトのスタックではなく、トラック間の「関係性」を定義することに重点を置いています。フェードイン/アウト、クロスフェード、トラックゲイン/ボリューム、ボリュームオートメーション、ダッキング、ボイスオーバーカーブ(音楽がナレーションと競合する場合の音声帯域の動的カット)、およびEQ、コンプレッサー、リミッター、ゲート、サチュレーション、ディレイ、リバーブ、コーラス、フェイザー、ビットクラッシュといったエフェクトチェーンをサポートします。オートメーションエンベロープは、トラックのボリュームや任意のエフェクトパラメータに描画でき、`<hf-audio-group>`バスを使用することで複数トラックを一括してサブミックスできます。 このスキルの核となるのは、プレビューとレンダリングで同一のWeb Audioグラフ実装が使用される点です。そのため、スクラブ中に聞こえる音がそのまま出力結果となります。エフェクトは`data-fx-chain`属性、オートメーションは`data-automation`属性、ボイスオーバーカーブ専用設定は`data-fx-carve`属性として、オーディオ要素自体または`<hf-audio-group>`に保持されます。これにより、チューニングのための二度手間が発生しません。 ボイスオーバーカーブ機能は特に強力で、音楽ベッド上のナレーションを際立たせるために、ベッド全体の音量を下げるのではなく、ナレーションが実際に使用する周波数帯域のみを動的にカットします。これにより、音楽の存在感を維持しながら、音声の明瞭性を確保できます。カーブの設定はベッド側に記述し、ソース(ボイス)はグループ化して指定します。これにより、編集の追加にも柔軟に対応できます。 トラブルシューティングのための診断ガイドやプリセットも充実しており、症状(こもっている、ハーシュ、明瞭性が低いなど)から適切なエフェクトやジョブを選択できます。ただし、音声の絶対的なスペクトル分析には注意が必要で、同じファイル内の無音部分やクリーンなオリジナルとの比較が推奨されています。ソーシングや音声生成は行わず、それらは`/media-use`スキル、クリップタイミングやトラックレイアウトは`/hyperframes-core`スキルの担当範囲です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/hyperframes-audio

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

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

ドキュメント

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

HyperFrames Audio は何をしますか?

ミックスとは、プロセッサのスタックではなく、関係性の集合です。単独では正しく聞こえる2つのトラックが、一緒になると聴くに堪えないことがあります。その修正方法は、ほとんどの場合「どちらかを下げる」ことではありません。2つのトラックが何を争っているのかを見つけ出し、それを必要とする方に与えることです。ここにあるすべてのツールは、それらの関係性の1つを表現するために存在します。

エフェクトはdata-fx-chainとして要素に配置され、プレビューとレンダリングは同じWeb Audioグラフを実行します。ライブコンテキストではスタジオとして、オフラインコンテキストではエンジンとして、すでに制御しているブラウザ内で動作します。各エフェクトの実装は1つであるため、スクラブ中に聞こえるものがそのまま書き出されます。調整を2回行う必要はありません。

クリップタイミングは /hyperframes-core が担当します。オーディオ/ビデオのトリムやソース範囲は data-start、data-duration、data-media-start を使用し、クロスフェードは異なるトラック上のクリップをオーバーラップさせます。このスキルは、配置済みトラックのフェードイン/フェードアウト、クロスフェードエンベロープ、トラックゲイン/トラックボリューム、ボリュームおよびエフェクトオートメーション、ダッキング/ボイスオーバーカーブ、そしてエフェクトチェーンを担当します。/media-useはソーシング、生成、前処理を担当します。

定数 data-playback-rate (0.1..10) は、同じタイミング、ソースオフセット、レートを使用するオーディオ/ビデオ要素をマッチングする場合、ピクチャーとピッチ保存サウンドに対してレンダリングセーフです。スピードランプは data-automation 内の rate レーンです(docs/reference/speed-ramps 参照)。これは定数よりも優先され、プレビューとレンダリングでピッチを保持します。HyperFramesは自動的な波形同期やドリフト補正を提供しません。 コピー可能なカット/クロスフェード/リタイムレシピについては、/hyperframes-core → references/creator-editing-recipes.md を使用してください。

3つの属性がすべてを保持します。これらはオーディオ/ビデオ要素自体に、または最初の2つについては <hf-audio-group> バスに配置されます(「複数トラックのための1つのバス」を参照)。

属性保持するもの
data-fx-chainエフェクト、シグナル順
data-automationこのトラックのボリュームまたはそのエフェクトパラメータ上のエンベロープ
data-fx-carveカーブ固有の設定。再導出可能にするため

出荷済みのエフェクトファミリーは、ゲイン、EQ(ハイパス、ローパス、ピーキング、シェルフ)、コンプレッサー、リミッター、ゲート、サチュレート、ディレイ、リバーブ、コーラス、フェイザー、ビットクラッシュです。

それぞれの正確なJSON、およびレーンが満たすべきルール:references/attributes.md。 パラメータ、範囲、単位を含むすべてのエフェクト:references/fx-registry.md。 聞こえないファイルの問題を特定する方法:references/diagnosis.md。 プリセット、名前付きジョブ、ワンノブプロファイル、および症状から修正へのテーブル:references/presets.md — チェーンを手動で構築する前にこれを読んでください。なぜなら、プリセットや名前付きジョブのいずれかが通常すでに問題を特定しているからです。

全体の構成

2つのオーサリングサーフェスがこれらの属性を書き込み、2つのランタイムが同じビルダーを通じてそれらを読み取ります。この共有された中間層こそが、プレビューがレンダリングを予測できる理由です。

flowchart TB
  voice["ボイストラック<br/>メディアファイル"]
  bed["ミュージックベッド<br/>メディアファイル"]

  subgraph AUTHOR["オーサリング — 属性を書き込む唯一のもの"]
    panel["スタジオ<br/>ボイスオーバーカーブコントロール"]
    script["scripts/carve.mjs<br/>ペアを検出"]
    analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
    panel --> analysis
    script --> analysis
  end

  voice --> analysis
  bed --> analysis

  subgraph ATTRS["ベッド要素に書き込まれる"]
    carveAttr["data-fx-carve<br/>sources · strength"]
    chainAttr["data-fx-chain<br/>peaking xN + gain, fromCarveタグ付き"]
    autoAttr["data-automation<br/>カーブされたパラメータごとに1つのレーン"]
  end

  analysis --> carveAttr
  analysis --> chainAttr
  analysis --> autoAttr

  subgraph SHARED["1つの実装、両方から読み取られる"]
    build["audioFxGraph.ts · buildFxChain"]
    sched["audioFxAutomation.ts · scheduleChainAutomation"]
  end

  chainAttr --> build
  autoAttr --> sched

  build --> preview["プレビュー<br/>live AudioContext<br/>attachElementFxChain"]
  sched --> preview
  build --> render["レンダリング<br/>ヘッドレスブラウザ内のOfflineAudioContext<br/>applyAudioFxChain"]
  sched --> render

  preview --> heard["スクラブ中に聞こえるもの"]
  render --> wav["処理済みWAV<br/>+ chainTailSeconds によりミックスがテイルを通過させる"]
  wav --> mix["エンジン · audioMixer<br/>ここでPCMに焼き込まれたボリュームレーン、グラフ内ではない"]
  mix --> out["レンダリングされたミックス"]

  edit["再生中の属性編集"] -.->|MutationObserver| preview

カーブ固有の設定は再生時に読み取られることはありません。再生されるのは、それによって生成されたチェーンとレーンです。data-fx-carveは、既存のカーブに対して強度を変更できるように存在しており、フィルターから逆算して推測する必要はありません。

カーブされたベッドの内部では、信号は最初にディップを通り、次にレベルマッチ、そしてあなたが自分で構築したものを通ります。そのため、後で追加するリミッターは依然として最後の天井として機能します。

flowchart LR
  src["デコードされたベッド"] --> p1["peaking<br/>400 Hz"]
  p1 --> p2["peaking<br/>1 kHz"]
  p2 --> p3["peaking<br/>1.6 kHz"]
  p3 --> g["gain<br/>レベルマッチ"]
  g --> hand["あなた自身のエフェクト<br/>例: リミッター"]
  hand --> dest["トラックゲイン、その後出力"]

  l1["レーン fx.n1.gain"] -.->|"その帯域における<br/>ボイスのレベルのエンベロープ"| p1
  l4["レーン fx.n4.gain"] -.->|"ベッドが全体的に<br/>どれだけダックするか"| g

まず、何が問題かを特定する

以下の表は「音がこもっている」から始まります。これは、誰かがすでに聴いてそう言ったことを前提としています。「これを修正して」とファイルを渡された場合、そのような情報はなく、あなたは聴くこともできないため、測定する必要があります。すべてを支配するルールは1つです。

単一の未知の音声の絶対スペクトルは診断できません。 フォルマントは±10 dB、基本周波数は85~255 Hz、文は終わりに近づくにつれて5~6 dB低下します。これらのすべてが単独では欠陥として読み取られ、そのすべてが話者自身のものです。

したがって、比較を行い、同じファイル内の何かと比較してください。可能であればクリーンなオリジナル、そうでなければポーズ(無音部分)。ギャップで聞こえるものはすべて付加的であり、ギャップのスペクトルは音声ではなくチャンネルそのものです。公開された平均スペクトルや合成されたコントロール音声との比較は機能しません。2人の話者はほとんどの欠陥よりも大きく異なり、このガイダンスの背後にある評価での2つの誤った回答は、まさにその比較から生じたものです。

オリジナルも使用可能な無音もない場合、静的な音色欠陥は真に未確定です。その旨を述べ、当てはまる測定値を提示し、1つを選択してそれに基づいてチェーンを構築しないでください。

コマンド、トラップ、および実践的なレシピ:references/diagnosis.md。誰も説明していないファイルを診断する前に読んでください。

症状から始める

帯域と種類がわかったら、オーディオの問題を特定します。ほとんどの悪いオーディオはこれらのうちの1つまたは2つであり、それぞれに出荷済みの回答があります。

こんな風に聞こえる使用するもの
下にハムやドスンという音rumble-cut、または80 Hzのhighpass
こもっている、胸に響くTame Boominess ジョブ (200 Hz)
くぐもっている、段ボールの後ろReduce Mud ジョブ (250 Hz)
言葉が聞き取りにくいAdd Clarity ジョブ (3 kHz)、またはベッドをカーブ
耳障りで疲れるSoften Harshness ジョブ (3.2 kHz)
一部の単語が他の単語よりはるかに大きいコンプレッサーで Evenness、または Even Out Levels
文の間の部屋の響きroom-gate
ボイスと音楽が競合するVoiceover carve — どちらかにEQをかけるのではない
ドライで、どこにも録音されていない感じroom-tight または room-natural
ただ「アマチュアっぽい」voice-clean(上記のうち4つを順に適用)

完全なカタログ、各プリセットの内容、帯域の用語、および意図的にカバーされていないもの(デエッシング、ノイズ除去、トーンマッチ):references/presets.md。

追加する前に減算し、フィルターの後にレベルを調整し、レベルの後に関係性を、キャラクターと天井は最後に。各ステップは、次のステップが聞くものを変えます。ハイパスの前に設定されたコンプレッサーは、ランブルを追いかけることに時間を費やします。

名前ではなく問題によってエフェクトファミリーを選ぶ

フィルター(highpass、lowpass、peaking、lowshelf、highshelf)は、トラックが占有できる周波数を決定します。これは、2つのソースが衝突する場合の最初のツールです。衝突は帯域で発生するためです。ベッドとボイスの両方が1~3 kHzを欲し、それをベッドから奪うことは、ミックス全体を下げるよりもベッドへの損失がはるかに少なくなります。ボイスへのハイパスはランブルに対する標準的な修正です。ローパスは意図的に暗くしたり、こもらせたりします。

ダイナミクス(gain、compressor、limiter、gate)は、トラックのレベルが時間とともにどのように振る舞うかを決定します。圧縮は、大きい音と小さい音の距離を狭め、小さい音を上げられるようにします。リミッターは天井です。何かを整形するのではなく、何も通過させないことを保証します。ゲートはしきい値以下のものを削除します。これは、フレーズ間の部屋の響きを消音する方法です。gainは単純なレベルステージであり、トラックが邪魔にならないように移動する必要がある場合に、オートメーションレーンが乗るものです。

非線形(saturate、bitcrush)は波形の形状を変更し、そこになかった高調波を追加します。トラックに補正ではなくキャラクターや粗さが必要な場合に使用します。そして、これは生成的であることを覚えておいてください。薄いソースをより濃くするのであって、よりクリーンにするわけではありません。

時間系(delay、reverb、chorus、phaser)は、トラックを空間に配置したり、幅を与えたりします。これらはミックスを最も簡単に台無しにするものです。なぜなら、テイルやデチューンされたコピーが、ボイスが必要とする同じ空間を占有するからです。何か他のものの_背後_に配置すべきものに使用し、ウェット量は単独で正しく聞こえる量よりも低く抑えてください。

チェーンはシリアルです。各エフェクトは、前のエフェクトが生成したものを処理します。したがって、補正フィルタリングは早い段階に、キャラクターは中間に、リミッターは最後に配置し、実際に天井として機能できるようにします。

ボイスオーバーカーブ

解決する問題。 ボイスの下のミュージックベッドは、ボイスを追いにくくします。反射的にベッド全体をダックさせると、効果はありますが、ベッドの存在感がすべて失われます。音楽はボイスオーバーの間中、弱々しくなります。しかし、ボイスはスペクトル全体を必要としているわけではありません。実際に占有する数帯域だけが必要です。カーブはそれらの帯域のみを奪い、ベッドは低域と高域を維持するため、ボイスが明瞭である間も音楽は音楽として機能し続けます。

これはエフェクトではなく、関係性です。 設定は_ベッド_(処理されるトラック)に配置され、リッスンするボイスを指定します。これはサイドチェインコンプレッサーとまったく同じです。小さくなるトラックを選択し、何がそれを小さくするかを選択します。ボイストラックにカーブを決して配置しないでください。 自分自身に対してカーブされたボイスは、微妙なミックスの選択ではなく、バグです。

すべてのボイス、そのうちの1つではありません。 sourcesはリストです。なぜなら、ベッドは通常、シーケンス全体(ナレーター、インタビューの回答、2人目のプレゼンター)の下で実行されるからです。これらは、何かが測定される前にベッド自身のクロック上で合計されます(mixCarveSources)。したがって、1つの分析ですべてをカバーします。帯域はそこにあるすべての音声から得られ、エンベロープはそのいずれかが発生している場所で上昇します。ベッドと同時に再生されないボイスは除外されます。それらはマスクできません。

複数のクリップIDに対するカーブは間違いです。クリップをグループ化し、グループに対してカーブを実行してください。 これはヒントではなく、不変条件です。クリップを1つずつ指定すると、完全に正しくなくてはならず、次の編集までしか正しくありません。後で追加された4つ目のナレーションクリップは、カーブの認識範囲外で再生され、ベッドはその下で静かにダックできなくなります。代わりにグループを指定すると、メンバーシップは分析時に解決されるため、後でグループに追加されたクリップは、sourcesに触れることなくカバーされます。

<!-- ナレーションをグループ化し、ベッドをグループに対してカーブする -->
<audio id="vo-intro" data-audio-group="voiceover" …></audio>
<audio id="vo-middle" data-audio-group="voiceover" …></audio>
<audio id="vo-outro" data-audio-group="voiceover" …></audio>

<audio id="music" data-fx-carve='{"enabled":true,"sources":["voiceover"],"strength":0.8}' …></audio>

グループではなく2つ以上のプレーンなクリップIDを指定するsourcesリストは、audio_carve_ungrouped_sources lintルールによってキャッチされます。これはまだ機能しますが、クリップが追加されたときに静かに腐敗するバージョンです。

カーブグループはボイスグループに保ってください。ベッド、SFX、音楽は含めないでください。 sources内のグループIDは、_すべての_分析時に_現在の_メンバーに解決されます。したがって、指定したグループは、書き込まれたときに測定されたトラックではなく、後で取得するグループになります。これが問題を引き起こす2つの方法を以下に示します。

  • ベッドが自身のソースグループ内にある。 ベッドはボイスとして自分自身に渡され、自身のコンテンツに対してカーブされます。これは、「トラックをそれ自身に対してカーブしてはいけない」ルールが、再分析の1回後に発生することを意味します。
  • SFXまたは音楽クリップがボイスグループ内にある。 次の分析でサイドチェインに入り、ベッドはシューという音の下でダックし始めます。属性を書き込んだ実行では測定されなかったにもかかわらずです。

どちらもカーブが書き込まれた瞬間には見えません。分析は検出したボイスを合計し、グループ解決を経由して往復しないため、最初のパスは真に正しく、次のパスのみが間違っています。したがって、各ロールに独自のグループを割り当ててください。ベッドにはmusic、ナレーションにはvoiceover、ヒットにはsfxとし、sourcesで指定されたグループにはボイスだけが含まれるようにしてください。

carve.mjsは、どちらかのケースを見つけるとグループ形式の書き込みを拒否し、クリップIDを記録し、どのメンバーがブロックしたかをstderrに出力します。その後、audio_carve_ungrouped_sourcesルールが配置を指摘します...

Individual skills in this repo

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

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

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.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

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.

関連スキル