Communitygithub.com

nateherkai/hyperframes-student-kit

비디오 편집 파이프라인의 두 번째 에이전트입니다. 말하는 사람의 녹화에서 더듬음, 반복된 단어, 잘못된 시작, 재녹음(다시 찍은 라인) 등 말하기 실수를 찾아 제거합니다. 무음 자르기 후에 사용되며, 실수 자르기, 더듬음/반복/필러 재시작 제거, flubs 정리, 최고 테이크 유지를 요청할 때 실행됩니다. 리뷰 게이트 방식으로 작동하여 각 컷을 컨텍스트와 승인 사유와 함께 제안한 후, 승인된 컷만 ffmpeg로 렌더링합니다. 단어 수준의 전사(transcript)가 필요합니다.

hyperframes-student-kit란 무엇인가요?

이 스킬은 'Cut Mistakes & Repeats (Pipeline Agent 2)'로, Hyperframes 비디오 편집 파이프라인의 두 번째 단계입니다. 1단계(무음 자르기)가 완료된 후 실행되어, 사람 편집자가 두 번째 패스에서 잘라내는 요소들인 더듬음(예: 'the the', 'I- I-'), 즉시 반복되는 단어, 잘못된 시작(중단 후 재시작하는 구절), 재녹음(깨끗한 테이크는 남기고 잘못된 테이크는 제거)을 제거합니다. 기계적 검출기와 사람의 판단을 결합한 '리뷰 게이트' 방식을 사용합니다. 먼저 `find-cut-candidates.mjs` 스크립트로 후보 컷을 생성한 후, 사용자가 각 후보를 맥락과 함께 검토하고 승인 여부를 결정합니다. 마지막으로 `apply-cuts.mjs` 스크립트가 승인된 컷만 ffmpeg(trim+concat)로 적용하여 A/V 동기화를 유지한 최종 비디오와 재타임된 전사를 생성합니다. 이 에이전트는 의도적인 강조나 수사적 반복과 실제 실수를 구분하지 못하므로, 사용자의 검토가 필수적입니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

실수 및 반복 자르기 (파이프라인 에이전트 2)

무음 자르기 이후에 실행되는 자동 편집의 두 번째 단계입니다. 사람 편집자가 두 번째 패스에서 잘라내는 요소들을 제거합니다: 더듬음("the the", "I- I-"), 즉시 반복되는 단어, 잘못된 시작(중단 후 재시작하는 구절), 재녹음(다시 녹음한 라인 — 깨끗한 테이크는 유지하고 잘못된 테이크는 버림).

무엇이 실수인지 결정하는 것은 공식이 아닌 판단입니다 — 강조 반복("never, never")과 수사적 중복("the first piece is, is this…")은 기계적으로 보면 더듬음과 동일하게 보입니다. 따라서 이 에이전트는 기본적으로 리뷰 게이트 방식입니다: 전체 컨텍스트와 함께 후보를 제시하고, 에이전트(와 사용자)가 결정하며, 승인된 컷만 렌더링됩니다.

사용 시기

  • "실수 잘라내기", "더듬음/반복 제거", "flubs 정리", "최고 테이크 유지", "잘못된 시작 자르기"
  • 마스터 편집 워크플로의 두 번째 단계로, 무음 자르기 출력에 대해 실행.

세 부분으로 구성된 흐름

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를 읽으십시오. 일반적인 오탐지: 강조 반복("it's never, never hands-off"), 연결 동사-의문문("the piece is, is this…"), 목록 나열.

각 항목에 대한 권장 사항과 함께 후보를 사용자에게 제시하고, 승인을 수집합니다. 승인된 컷을 파일에 작성합니다:

{ "cuts": [ { "start": 100.93, "end": 101.06, "reason": "I- 잘못된 시작" }, ... ] }

(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를 빼면 드라이 런(dry run)입니다.

결과 검토

공유 검토 도구를 사용하여 컷을 눈으로 확인하고 경계를 점검합니다:

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

참고 사항

  • 매우 깔끔한 전달의 경우 실제 컷이 거의 또는 전혀 없을 수 있습니다 — 이는 유효한 결과입니다. 할당량을 맞추기 위해 자연스러운 말을 자르지 마십시오.
  • 두 개의 말한 단어 사이의 컷은 하드 조인입니다. 더듬음/잘못된 시작의 경우 일반적으로 깔끔하며, 더 타이트한 오디오의 경우 나중에 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.

관련 스킬