免费在 GitHub 公开

cut-mistakes

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

查看安装方法

包含的文件（3）

SKILL.md4.1 KB
scripts/apply-cuts.mjs8.6 KB
scripts/find-cut-candidates.mjs8.1 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Cut Mistakes & Repeats (Pipeline Agent 2)

Second step of the automated edit, run after cut-silences. It removes the things a human editor cuts on a second pass: stutters ("the the", "I- I-"), immediately repeated words, false starts (an abandoned phrase that restarts), and retakes (a line re-recorded — keep the clean take, drop the botched one).

Deciding what counts as a mistake is judgment, not a formula — emphatic repetition ("never, never") and rhetorical doubling ("the first piece is, is this…") look identical to a stutter mechanically. So this agent is review-gated by default: it surfaces candidates with full context; the agent (and the user) decide; only approved cuts are rendered.

When to use

"cut the mistakes", "remove stutters / repeats", "clean up the flubs", "keep the best take", "cut false starts"
As the second stage of the master edit workflow, on cut-silences' output.

The three-part flow

1. Find candidates (mechanical)

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

Input is normally Agent 1's <stem>.silence-transcript.json, so cuts land on the already-silenced timeline. Writes:

<stem>.cut-candidates.json — structured candidates (type, confidence, proposed cut range, removes/keeps text, context, recommendation)
<stem>.cut-candidates.md — readable proposal

Candidate types: stutter (immediate word repeat), retake (duplicate/near-duplicate segment via Jaccard similarity), false_start (short abandoned phrase that restarts).

2. Review (the gate — REQUIRED)

Read each candidate in context and decide keep-or-cut. The mechanical detector cannot tell intentional emphasis/rhetoric from a real flub, so do not trust recommend blindly — read removes + context. Common false positives: emphatic repetition ("it's never, never hands-off"), copula-then-question ("the piece is, is this…"), listing.

Present the candidates to the user with a recommendation per item; collect approvals. Write the approved cuts to a file:

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

(start/end in seconds on the input transcript/video timeline. You can widen a candidate's range — e.g. for a retake, cut from the botched take's start to the clean restart.)

3. Apply approved cuts

node .claude/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

Writes the EDL, a re-timed <stem>.mistakes-transcript.json (feeds the motion-graphics agent + validate-beat-sync.mjs), a decisions log, and — with --apply — the cut video (ffmpeg trim+concat, A/V in sync). Drop --apply for a dry run.

Reviewing the result

Use the shared review tool to eyeball the cuts and spot-check boundaries:

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

Notes

A very clean delivery may yield few or zero real cuts — that's a valid outcome; don't cut natural speech to hit a quota.
Cuts between two spoken words are hard joins. They're usually clean for stutters/false starts; for tighter audio a 20-30ms fade can be added later.
Hand the mistakes-transcript.json + the clean video to Agent 3 (motion graphics / tiered cards).

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

cut-silences

免费

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.

中文简介正在准备中。当前显示原文说明。