Communitygithub.com

nateherkai/hyperframes-student-kit

映像編集パイプラインの第2エージェント。トーキングヘッド録画から、どもり、繰り返し、言い間違い、リテイク(再録音)などの発話上のミスを検出して削除します。

hyperframes-student-kit とは?

このエージェント「Cut Mistakes & Repeats (Pipeline Agent 2)」は、映像編集ワークフローの第2ステップとして機能し、『cut-silences』の出力に対して適用されます。主な役割は、動画内の「どもり(例: the the)」、「即時繰り返し」、「false start(言いかけの放棄)」、「リテイク(再録音)」といった発話ミスを自動検出し、人間の編集者が2回目のパスで削除するような不要部分を取り除くことです。 このエージェントの特徴は、機械的な検出だけでは意図的な強調(例: never, never)と実際のミスを区別できないことを考慮し、**レビュー必須(review-gated)** の設計になっている点です。検出された削除候補はコンテキスト付きで提案され、代理人(もしくはユーザー)が承認したカットのみが実際に適用されます。 ワークフローは3段階で構成されています。まず、ワードレベルのトランスクリプトを基に機械的な候補検出(stutter/retake/false startの分類と信頼度付き)。次に、各候補をコンテキスト内で確認し承認するレビュー工程。最後に、承認されたカットをffmpegでレンダリング(トリム+結合)し、再タイミングされたトランスクリプトや決定ログを出力します。 このツールはClaude Code/Codex/CursorなどのAIエージェントと連携し、人間の編集者が行う細かいカット作業を自動化することで、編集効率を大幅に向上させます。特にトーキングヘッド動画やチュートリアル、プレゼンテーション動画の編集に最適です。

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

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

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

ドキュメント

ミスと繰り返しのカット(パイプラインエージェント2)

自動編集の第2ステップ。cut-silences の後に実行します。人間の編集者が2回目のパスで削除するようなものを取り除きます:どもり(「the the」「I- I-」)、即時繰り返し、false start(放棄されたフレーズ)、リテイク(再録音されたライン — きれいな方を残し、失敗した方を削除)。

何をミスとみなすかは 判断であり、公式ではありません — 強調の繰り返し(「never, never」)や修辞的ダブり(「the first piece is, is this…」)は機械的にどもりと区別がつきません。そのため、このエージェントはデフォルトで レビュー必須(review-gated) です:候補をコンテキスト付きで提示し、エージェント(およびユーザー)が判断、承認されたカットのみがレンダリングされます。

使用するタイミング

  • 「ミスをカット」「どもり/繰り返しを削除」「フラブを修正」「最良のテイクを残す」「false startをカット」
  • マスター編集ワークフローの第2段階として、cut-silencesの出力に対して。

3段階のフロー

1. 候補の検出(機械的)

node .agents/skills/cut-mistakes/scripts/find-cut-candidates.mjs \
  <silence-transcript.json> --out-dir video-projects/<slug>/assets

入力は通常エージェント1の <stem>.silence-transcript.json で、カットは既に無音処理されたタイムラインに適用されます。出力:

  • <stem>.cut-candidates.json — 構造化された候補(タイプ、信頼度、提案された cut 範囲、removes/keeps テキスト、コンテキスト、推奨)
  • <stem>.cut-candidates.md — 読める提案

候補タイプ:stutter(即時単語繰り返し)、retake(Jaccard類似度による重複/ほぼ重複セグメント)、false_start(放棄された短いフレーズ)。

2. レビュー(必須)

各候補を コンテキスト内で 読み、keep-or-cutを判断します。機械的検出器は意図的な強調/修辞と実際のフラブを区別できないため、recommend を盲信せず、removes + context を読んでください。よくあるfalse positive:強調の繰り返し(「it's never, never hands-off」)、コピュラ+疑問(「the piece is, is this…」)、リスト。

候補をユーザーに提示し、各項目に推奨を付けて、承認を収集します。承認されたカットをファイルに書き込みます:

{ "cuts": [ { "start": 100.93, "end": 101.06, "reason": "I- false start" }, ... ] }

(start/end は入力トランスクリプト/動画タイムライン上の秒数。候補の範囲を広げることも可能です — 例:リテイクの場合、失敗テイクの開始からクリーンな再開までをカット。)

3. 承認されたカットを適用

node .agents/skills/cut-mistakes/scripts/apply-cuts.mjs \
  <silence-transcript.json> --cuts approved-cuts.json \
  --video video-projects/<slug>/assets/edited-silenced.mp4 \
  --output video-projects/<slug>/assets/edited-clean.mp4 --apply

EDL、再タイミングされた <stem>.mistakes-transcript.json(モーショングラフィックスエージェント + validate-beat-sync.mjs に供給)、決定ログ、そして --apply 付きでカット動画(ffmpeg trim+concat、A/V同期)を出力します。--apply を外すとドライランになります。

結果のレビュー

共有レビューツールを使用してカットを目視確認し、境界をチェックします:

node scripts/build-edl-review.mjs <stem>.mistakes-edl.json \
  --original video-projects/<slug>/assets/edited-silenced.mp4 \
  --edited   video-projects/<slug>/assets/edited-clean.mp4 \
  --output   video-projects/<slug>/assets/mistakes-review.html
npx serve . -p 8080 -n

注意事項

  • 非常にクリーンな収録の場合、実際のカットがゼロまたはごくわずかになることもあります — それは有効な結果です。目標を達成するために自然な発話をカットしないでください。
  • 2つの話し言葉の間のカットはハードジョインになります。どもり/false startの場合は通常クリーンですが、よりタイトなオーディオの場合は後で20-30msのフェードを追加できます。
  • mistakes-transcript.json + クリーン動画を エージェント3(モーショングラフィックス / 段階カード) に渡します。

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

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.

関連スキル