Communitygithub.com

nateherkai/hyperframes-student-kit

影片編輯管線的第二個代理。尋找並移除說話頭錄製中的口語錯誤——結巴、重複詞、 false starts 和重錄片段。在裁切靜音後使用,用於裁切錯誤、移除結巴/重複/填充詞重新開始、清理口誤,或保留最佳版本。以審查為閘門:它會提出每個裁切建議,附帶前後文和理由供批准,然後僅透過 ffmpeg 渲染批准的裁切。需要逐字稿。

hyperframes-student-kit 是什麼?

這個技能是影片編輯自動化管線中的一個代理,專門處理說話頭錄製中的口語錯誤。它會機械式地找出潛在的錯誤候選項,例如結巴(例如「這、這個」)、立即重複的詞、 false starts(一個被放棄並重新開始的短語)以及重錄片段(保留乾淨的版本,丟棄失敗的版本)。然而,由於區分真正的錯誤與修辭上的重複(例如「絕不、絕不」)需要主觀判斷,因此該代理預設會將所有候選項提交審查,由使用者或上層代理決定哪些裁切應該執行。它支援 Claude Code、Cursor 和 Codex 等平台,作為「裁切靜音」之後的第二個步驟。工作流程包含三個部分:首先執行一個指令碼來產生候選裁切(包含類型、信心指數和建議),然後使用一個審查閘門,讓使用者可以閱讀前後文並批准或拒絕每個裁切,最後執行另一個指令碼來應用批准的裁切,透過 ffmpeg 產生一個 A/V 同步的新影片檔案,並輸出一個已調整時間軸的逐字稿以供後續代理使用。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

裁切錯誤與重複(管線代理 2)

自動化編輯的第二個步驟,在 裁切靜音 之後執行。它會移除人類編輯在第二輪時會裁切的東西:結巴(「這個這個」、「我- 我-」)、立即重複的詞、 false starts(一個被放棄並重新開始的短語)以及重錄片段(保留乾淨的版本,丟棄失敗的版本)。

決定什麼算是錯誤是 判斷,而非公式 — 強調性的重複(「絕不、絕不」)和修辭上的雙重(「第一件是,是這個…」)在機械上看起來與結巴完全相同。因此這個代理預設是 以審查為閘門:它會呈現候選項,附帶完整的前後文;由代理(和使用者)決定;只有批准的裁切才會被渲染。

何時使用

  • 「裁切錯誤」、「移除結巴 / 重複」、「清理口誤」、「保留最佳版本」、「裁切 false starts」
  • 作為主編輯工作流程的第二階段,在裁切靜音的輸出上執行。

三部分流程

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. 審查(閘門 — 必須)

在前後文中閱讀每個候選項,並決定保留或裁切。機械式偵測器無法區分有意的強調/修辭與真正的口誤,因此不要盲目信任 recommend — 閱讀 removes + context。常見的誤報:強調性重複(「它絕不、絕不放手」)、系詞後接疑問(「那件是,是這個…」)、列舉。

向使用者呈現候選項,每項附帶建議;收集批准。將批准的裁切寫入一個檔案:

{ "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 裁切+連接,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

備註

  • 非常乾淨的錄製內容可能產生很少或零個實際裁切 — 這是一個有效的結果;不要為了達到配額而裁切自然的談話。
  • 兩個口語詞之間的裁切是硬接合。對於結巴/false starts 來說通常很乾淨;對於更緊密的音訊,可以在之後加入 20-30 毫秒的淡出。
  • 將 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.

相關技能