Communitygithub.com

nateherkai/hyperframes-student-kit

비디오 편집 파이프라인의 첫 번째 에이전트입니다. 토킹헤드 녹화에서 묵음과 데드 에어를 제거합니다. 사용자가 침묵 제거, 일시 정지 다듬기, 데드 에어/간격 제거, 또는 단어 수준 전사본이 주어졌을 때 원본 비디오의 템포를 조정하도록 요청할 때 사용하십시오. 편집 목록(EDL), 다운스트림 에이전트용 재타이밍 전사본, 그리고 선택적으로 ffmpeg를 통해 편집된 비디오를 생성합니다. 실수, 반복, 또는 잘못된 시작은 자르지 않습니다. 이는 실수 제거 에이전트의 작업입니다.

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

이 스킬은 자동화된 비디오 편집 파이프라인의 첫 번째 단계인 'Cut Silences'를 구현합니다. 사용자가 '침묵 제거', '일시 정지 다듬기', '데드 에어 제거', '템포 조정'과 같은 요청을 할 때 활성화됩니다. 핵심 기능은 단어 수준 전사본을 기반으로 하여 첫 단어 전과 마지막 단어 후의 데드 에어, 그리고 설정된 임계값보다 긴 단어 간 일시 정지를 식별하고 제거하는 것입니다. 제거 시 완전한 무음이 아닌 자연스러운 호흡 간격을 유지하여 편집된 영상이 부자연스럽지 않도록 합니다. 이 스킬은 결정론적으로 작동하며 결과물로 편집 결정 목록(EDL), 재타이밍된 전사본, 그리고 ffmpeg 필터그래프를 생성하여 다음 에이전트(실수 제거)와 비트 동기화 검증기가 원활하게 작동할 수 있도록 합니다. 주로 ElevenLabs Scribe 형식의 전사본을 입력받으며, 선택적으로 원본 비디오 파일을 제공하면 ffmpeg를 이용한 실제 편집까지 수행할 수 있습니다.

지원 대상~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, 재인코딩, A/V 동기화 유지)
#    실제 ffmpeg를 실행하려면 --apply 추가
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가 있을 때만)

stdout으로 출력되는 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.

관련 스킬