Communitygithub.com

nathanherkai/silence-cutter-student-kit

動画編集パイプラインのエージェント1です。トーキングヘッド録画から無音と空白を削除します。無音のカット、ポーズのトリミング、間の削除、生ビデオのテンポ調整を求められたときに使用します。ワードレベルのトランスクリプトに基づいて、編集リスト(EDL)、下流のエージェント向けの再調整済みトランスクリプト、オプションでffmpegによるカット済みビデオを生成します。ミス、リピート、言い間違いはカットしません。これはcut-mistakesエージェントの役割です。

silence-cutter-student-kit とは?

このエージェントは、トーキングヘッド形式の動画編集パイプラインにおける最初の処理ステップです。生の録画とワードレベルのトランスクリプトを入力として、無音部分(最初の単語の前、最後の単語の後、および設定された閾値よりも長い単語間のポーズ)のみを除去します。ポーズは完全に削除されるわけではなく、自然な呼吸の間隔(文末や長いポーズに応じて0.14秒〜0.24秒)に短縮されます。これにより、話者の言葉そのものは一切変更されず、言い間違いや繰り返し、言い直しなどは後続のcut-mistakesエージェント(エージェント2)が処理します。このエージェントは決定論的かつトランスクリプト駆動で動作するため、出力されるタイムスタンプは編集後のタイムラインに基づいており、下流のエージェントやビート同期バリデーターがそのまま利用できます。ffmpegを使用して実際にビデオをレンダリングすることも可能で、出力として編集リスト(EDL)、再調整済みトランスクリプト、ffmpegフィルターグラフなどを生成します。Claude Code、Cursor、CodexなどのAIエージェントツールと連携して使用されることを想定しており、コマンドラインから直接実行できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/cut-silences

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

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

ドキュメント

無音カット(パイプラインエージェント1)

自動編集の最初のステップ。生録画とそのワードレベルのトランスクリプトを受け取り、無音のみ(最初の単語の前と最後の単語の後のデッドエア、および閾値より長い単語間のポーズ(自然な呼吸の長さに短縮され、完全にゼロギャップにはならない))を除去します。話者の言葉はそのまま維持され、言い間違い、リテイク、吃音は cut-mistakes エージェント(エージェント2)の担当です。

このエージェントは決定論的かつトランスクリプト駆動であるため、その出力 (*.silence-transcript.json) は次のエージェントやビート同期バリデーターにそのまま渡せます。

使用するタイミング

  • 「無音をカットして」「ポーズをトリミングして」「間を削除して」「テンポを詰めて」
  • マスター編集ワークフローの最初のステージとして、文字起こし直後に実行します。

前提条件

ワードレベルのトランスクリプトJSONが必要です。ElevenLabs Scribe形式 ({ words: [{ text, start, end, type }], audio_duration_secs }) または汎用の { words: [{ text, start, end }] } のいずれかに対応しています。ワークスペースの文字起こしツールで生成してください:

node scripts/transcribe-elevenlabs.mjs path/to/raw.mp4    # -> path/to/raw.json

使い方

# 1) 計画のみ — カットを計算し、EDLと再調整済みトランスクリプトを書き出します(ビデオには触れません)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --out-dir video-projects/<slug>/assets

# 2) ビデオあり — ffmpegコマンドも書き出します(まだレンダリングはしません)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --video video-projects/<slug>/assets/raw.mp4 --out-dir video-projects/<slug>/assets

# 3) カット済みビデオをレンダリング(ローカルffmpeg、再エンコード、音声・映像同期)
#    --apply を追加して実際にffmpegを実行します
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --video video-projects/<slug>/assets/raw.mp4 --apply \
  --output video-projects/<slug>/assets/edited-silenced.mp4

オプション

フラグデフォルト意味
--video <path>—ソースビデオのパス。指定するとffmpegコマンド生成/レンダリングが有効になります
--out-dir <dir>トランスクリプトと同じディレクトリ出力先ディレクトリ
--output <path><video-stem>.silenced.mp4カット済みビデオの出力パス
--gap <s>0.55トリミング対象とみなす最小のポーズ(秒)
--head-pad <s>0.22最初の単語の前に残す無音の長さ(秒)
--tail-pad <s>0.34最後の単語の後に残す無音の長さ(秒)
--applyoff実際にffmpegを実行してカットをレンダリングします

判定方法(無音ルール)

  • --gap(0.55秒)未満のポーズはそのまま維持されます — 自然な発話リズムの範囲です。
  • トリミングされるポーズの場合、自然な呼吸の長さが保持され、文脈に応じて調整されます:長いポーズ(2秒以上)では0.24秒、文末記号(. ! ?)の後では0.20秒、それ以外では0.14秒。保持される呼吸は、直前のフレーズの終わり側にやや寄せられます。
  • 先頭/末尾のデッドエアは--head-pad / --tail-padにトリミングされます。
  • 削除範囲はマージされ、保持範囲はその補集合となります。カットはffmpegのtrim/atrim + concatフィルターグラフ(*.silence-filter.txtファイルに書き出され、-/filter_complex経由で渡されます)でレンダリングされるため、映像と音声の同期が保たれます。

出力(--out-dirに書き出されます)

ファイル目的
<stem>.silence-edl.json保持/削除範囲、時間、パラメータ — 編集リスト
<stem>.silence-transcript.json編集後のタイムラインに合わせて再調整された単語(エージェント2 + ビートで使用)
<stem>.silence-decisions.md人間が読める形式のサマリーと、トリミングされた最大のポーズ一覧
<stem>.silence-filter.txtffmpegフィルターグラフ(--video指定時のみ)
<video-stem>.silenced.mp4カット済みビデオ(--apply指定時のみ)

標準出力に表示されるJSONサマリーには、removed、removedPct、範囲数、出力パスが含まれます。マスターワークフローでのログ記録や連鎖に便利です。

チューニングの注意点

  • トーキングヘッドYouTubeのデフォルト(--gap 0.55)では、通常の生テイクの約15〜20%が純粋な無音として削除されます。--gapを下げるとよりタイトで速いカットに、上げるとより自然な呼吸の間隔が維持されます。
  • 文境界でのカットが強すぎると感じる場合は、文末の呼吸の長さを引き上げるか、--gapを引き上げてください。

次のエージェントへの引き継ぎ

<stem>.silence-transcript.json(およびレンダリングされていればsilenced.mp4)を cut-mistakes エージェントに渡します。タイムスタンプがすでに編集後のタイムラインに基づいているため、下流のビートタイミングやscripts/validate-beat-sync.mjsは追加調整なしで動作します。

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

関連スキル