Communitygithub.com

Avenox Studio — オペレータールーター

Avenox Studio — ローカルファーストのYouTube動画制作パイプライン(ROUTER、最初に読む)。動画の編集、カット、制作、アセンブル、キャプション、スコア、レンダリング、またはモーショングラフィックスの作成など、あらゆるリクエストに使用します。オープンソースツール(auto-editor、mlx-whisper、MLT/melt、ffmpeg)とHyperFramesによるアニメーショングラフィックスをラップします。トリガー:「この動画を編集」「録画をカット」「グラフィックスを作成」「キャプションを抽出」「最終レンダリング」、ジョブ名、または動画パイプラインに関するあらゆる内容。人間はディレクター兼品質ゲート、エージェントはオペレーターです。

Avenox Studio — オペレータールーター とは?

Avenox Studio は、ローカルマシン上で動作するエージェント操作型の動画制作パイプラインです。ユーザーがディレクターとして品質を監視し、AIエージェントが実際の編集・グラフィックス・レンダリング作業を実行します。すべての処理はローカルで行われるため、クラウドへのアップロードや専用のオンラインエディターは不要で、プライバシーと高速な反復が可能です。このスキルは主にmacOS(Apple Silicon)向けに最適化されていますが、適切なツールを置き換えればLinuxでも動作可能です。パイプラインは7つのステップ(取り込み、ラフカット、グラフィックス、アセンブル、キャプション、音楽、書き出し)で構成され、各ステップで利用可能なスクリプトやHyperFramesスキルが提供されています。最も重要なルールは、必ずプレビューとディレクターレビューを経てから最終レンダリングを行うことであり、未確認の最終版を生成することは禁止されています。ブランド仕様は厳格に守る必要があり、フレームデザインは高級感のある編集品質を重視し、AI的なありふれた装飾(ネオン、グラデーション、ガラスモーフィズム、3D光沢など)を避けるように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/avenoxai/avenoxskills/tree/HEAD/skills/avenox-video

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

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

ドキュメント

Avenox Studio — オペレータールーター は何をしますか?

ローカルファースト、エージェント操作型動画パイプラインのための高速オペレーターガイド。 すべては自分のマシン上で実行されます。クラウドエディターも、アップロードしてレンダリングもありません。

人間は指示と品質承認を行い、エージェントがパイプラインを実行します。

セットアップ

export STUDIO_JOBS="$HOME/video/projects"   # 重いメディアファイルはここに配置
export STUDIO_ROOT="/path/to/this/repo"     # スクリプト、テンプレート、ブランド設定

要件: macOS(h264_videotoolboxによるハードウェアエンコード;mlx-whisper用にApple Silicon)、ffmpeg、python3、melt/MLT、Node(HyperFrames用)。Linuxでもlibx264とCUDA Whisperビルドに置き換えればほとんど動作します。

運用原則

  1. メディアの規律。 重いメディアは決してクラウド同期フォルダに入れないでください。同期は数GBの中間ファイルでスラッシングを起こし、書き込み中のファイルを破損させる可能性があります。ジョブは$STUDIO_JOBS/<job>/(raw/ cut/ graphics/ audio/ outputs/)に配置します。ノートシステムには頭脳(このシステム、ブランド仕様、edit.json計画)のみを保持します。
  2. ディレクターループ。 プレビュー(グラフィックスの静止画+高速ドラフトレンダリング)を生成 → フィードバックを送信 → その後でのみ最終レンダリング。承認なしに最終版を出荷しないでください。これは最も重要なルールです。未レビューの最終版をレンダリングするエージェントは、拒否されたカットで何時間も無駄にすることになります。
  3. ブランドは提案ではなく厳格な制約です。 グラフィックスを作成する前にbrand/frame.mdを読んでください。一度定義したらロックします。(リファレンス実装は意図的に「AIの粗雑な出力」とは逆の方向性です:高級な編集、温かみのある紙+インク+単一のアクセントカラー、ネオン/グラデーション/ガラスモーフィズム/3D光沢は不使用。)
  4. フォーマット: YouTube 16:9 1080p60。プリセットはbrand/presets/youtube-16x9.jsonにあり。
  5. 仕上げはハイブリッド。 ドラフトを自動生成。同じ.mltファイルをKdenliveまたはShotcutで開いて手動仕上げが可能。味付けの自動化は試みないでください。
  6. 文字起こしはデフォルトでLOCAL mlx-whisper、モデルはwhisper-large-v3-turbo—高速、無料、非英語音声にも強い。注意:ほとんどのLLMルーティングプロキシはwhisperエンドポイントを公開していません。リモートを使用する場合は、専用の音声APIを使用してください。

スクリプト(scripts/)

スクリプト機能
autocut.sh IN.mp4 [balanced|aggressive|conservative]無音カット → _cut.xml(Premiere)または --export バリアント
transcribe.py IN.mp4 PREFIX→ transcript/PREFIX_timed.json + _narration.txt
mltgen.py edit.json out.mlt --base <job-dir>編集リスト → MLTプロジェクト(Kdenlive/Shotcut/melt)
vrender.sh project.mlt out.mp4 [fast|quality]レンダリング(fast = HWドラフト、quality = CRF18マスター)
grabshot.shクリップボードのスクリーンショット → ディスク
slides2png.shレガシーな静的スライド — HyperFramesを推奨
remove-silence.pyスタンドアロン無音除去

7つのステップ

  1. 取り込み — 生データをコピー → $STUDIO_JOBS/<job>/raw/。指示と実際に必要なセグメントを確認。
  2. ラフカット — autocut.sh raw.mov balanced → cut/screen_cut.mp4; transcribe.pyでスクリプトを生成。完全なレシピは avenox-roughcut スキルを参照。
  3. グラフィックス — HyperFrames。hyperframesスキルを経由 → 通常は motion-graphics(短いビート)、faceless-explainer(コンセプト説明)、または general-video。最初にbrand/frame.mdを読むこと。アニメーションMP4をgraphics/にレンダリング。完全なレシピは avenox-graphics スキルを参照。
  4. アセンブル — edit.jsonを作成(テンプレートはtemplates/edit.json)。cut/*.mp4 + graphics/*.mp4 + 音楽を組み合わせ → mltgen.py edit.json project.mlt --base <job-dir>。
  5. キャプション — transcribe.py → .srt。brand/caption-corrections.jsonを適用(caption-corrections.example.jsonからコピー — ASRが頻繁に誤認識する用語の検索/置換マップ)。YouTube CCとして書き出し、焼き込みはしない。
  6. 音楽 — すべての下にBGM、ボーカル下でサイドチェインダッキング、ターゲットは約-14 LUFS。CREDITS.mdで帰属を追跡。
  7. 書き出し — vrender.sh project.mlt draft.mp4 fast → ディレクターレビュー → vrender.sh … final.mp4 quality → スクラッチファイルを整理。

グラフィックスの品質基準

HyperFramesクリップはbrand/frame.mdに従わなければなりません。タイポグラフィ主導で、抑制の効いた、重みのある動きを優先します。動きが必要ないビートでは、クリーンな静止フレームで問題ありません — 動かすために動かさないでください。

参考

  • ラフカット: avenox-roughcut · グラフィックス: avenox-graphics
  • HyperFramesスキル: hyperframes(ルーター)、hyperframes-cli、 hyperframes-animation、hyperframes-creative、motion-graphics、 faceless-explainer、general-video
  • ブランド仕様: brand/frame.md(brand/frame.template.mdから記入)

関連スキル