Communitygithub.com

nateherkai/hyperframes-student-kit

Agent 1 der Videobearbeitungspipeline. Entfernt Stille und tote Luft aus einer Talking-Head-Aufnahme. Verwenden, wenn aufgefordert, Stille zu schneiden, Pausen zu trimmen, tote Luft / Lücken zu entfernen oder das Tempo eines Rohvideos zu straffen, basierend auf einem Wort-für-Wort-Transkript. Erzeugt eine Edit Decision List (EDL), ein neu getimtes Transkript für nachgelagerte Agenten und optional das geschnittene Video mittels ffmpeg. Schneidet KEINE Fehler, Wiederholungen oder Fehlstarts – das ist Aufgabe des cut-mistakes-Agenten.

Was ist hyperframes-student-kit?

Diese Fähigkeit ist der erste Schritt einer automatisierten Videobearbeitungspipeline, die speziell für Talking-Head-Aufnahmen entwickelt wurde. Sie nimmt ein Rohvideo und dessen Wort-für-Wort-Transkript entgegen und entfernt ausschließlich Stille: tote Luft vor dem ersten Wort und nach dem letzten Wort sowie Pausen zwischen Wörtern, die länger als ein Schwellwert sind. Diese werden auf eine natürliche Atempause gestutzt, nie auf eine harte Null-Lücke. Die gesprochenen Wörter bleiben unangetastet – Fehlstarts, Wiederholungen und Gestotter werden vom nachgelagerten ‚cut-mistakes‘-Agenten behandelt. Der Agent arbeitet deterministisch und transkriptgesteuert, sodass seine Ausgabe (eine EDL und ein neu getimtes Transkript) sauber an nachfolgende Agenten und einen Beat-Sync-Validator übergeben werden kann. Die unterstützte Plattform ist die Kommandozeile mit Node.js und ffmpeg. Der Agent erzeugt eine Reihe von Ausgabedateien, darunter die Edit Decision List, das neu getimte Transkript, eine menschenlesbare Zusammenfassung und bei Angabe einer Videodatei optional das geschnittene Video. Er ist als erster Agent der Pipeline nach der Transkription konzipiert und bereitet die Daten für die nächsten Schritte wie das Entfernen von Fehlern vor.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Stille schneiden (Pipeline-Agent 1)

Erster Schritt der automatisierten Bearbeitung. Nimmt eine Rohaufnahme + ihr Wort-für-Wort-Transkript und entfernt nur Stille: tote Luft vor dem ersten Wort und nach dem letzten Wort sowie Zwischenwort-Pausen, die länger als ein Schwellwert sind (auf eine natürliche Atempause gestutzt, niemals eine harte Null-Lücke). Die gesprochenen Wörter bleiben unberührt – Fehlstarts, Neuansätze und Stottern sind Aufgabe des cut-mistakes-Agenten (Agent 2).

Dieser Agent arbeitet deterministisch und transkriptgesteuert, sodass seine Ausgabe (*.silence-transcript.json) sauber an die nächsten Agenten und den Beat-Sync-Validator übergeben werden kann.

Verwendung

  • „Schneide die Stille“, „Trimme die Pausen“, „Entferne tote Luft“, „Straffe das Tempo“
  • Als erster Schritt des Master-Bearbeitungsworkflows, direkt nach der Transkription.

Voraussetzungen

Ein Wort-für-Wort-Transkript im JSON-Format. Entweder das ElevenLabs Scribe-Format ({ words: [{ text, start, end, type }], audio_duration_secs }) oder ein generisches { words: [{ text, start, end }] }. Eines mit dem Arbeitsbereichs-Transkriptor erstellen:

node scripts/transcribe-elevenlabs.mjs path/to/raw.mp4    # -> path/to/raw.json

Verwendung

# 1) Nur Planung — den Schnitt berechnen, EDL + neu getimtes Transkript schreiben (kein Video angefasst)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --out-dir video-projects/<slug>/assets

# 2) Mit einem Video — auch den ffmpeg-Befehl schreiben (wird noch nicht gerendert)
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) Das geschnittene Video rendern (lokales ffmpeg, Neucodierung, A/V synchronisiert)
#    --apply hinzufügen, um ffmpeg tatsächlich auszuführen
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

Optionen

FlagStandardBedeutung
--video <path>—Quellvideo; aktiviert den ffmpeg-Befehl / das Rendern
--out-dir <dir>neben dem TranskriptVerzeichnis, in das die Ausgaben geschrieben werden
--output <path><video-stem>.silenced.mp4Pfad des geschnittenen Videos
--gap <s>0.55Mindestpause, die als kürzbare Stille behandelt wird
--head-pad <s>0.22Stille, die vor dem ersten Wort belassen wird
--tail-pad <s>0.34Stille, die nach dem letzten Wort belassen wird
--applyausffmpeg tatsächlich ausführen, um den Schnitt zu rendern

Entscheidungsfindung (die Stille-Regeln)

  • Pausen unterhalb von --gap (0,55s) werden belassen – natürlicher Sprechrhythmus.
  • Bei einer gekürzten Pause wird eine natürliche Atempause beibehalten, skaliert nach Kontext: 0,24s bei langen Pausen (≥2s), 0,20s nach einem Satzende (. ! ?), sonst 0,14s. Die beibehaltene Atempause ist etwas zum Ende der vorherigen Phrase hin geneigt.
  • Tote Luft am Anfang/Ende wird auf --head-pad / --tail-pad gekürzt.
  • Löschbereiche werden zusammengeführt; Beibehalte-Bereiche sind das Komplement. Der Schnitt wird mit einem ffmpeg trim/atrim + concat Filtergraphen gerendert (geschrieben in ein *.silence-filter.txt-Skript und über -/filter_complex übergeben), sodass Video und Audio synchron bleiben.

Ausgaben (geschrieben in --out-dir)

DateiZweck
<stem>.silence-edl.jsonBeibehalte-/Löschbereiche, Dauern, Parameter – die Edit Decision List
<stem>.silence-transcript.jsonWörter auf die bearbeitete Zeitleiste neu getimt (für Agent 2 + Beats)
<stem>.silence-decisions.mdMenschenlesbare Zusammenfassung + größte gekürzte Pausen
<stem>.silence-filter.txtDer ffmpeg Filtergraph (nur mit --video)
<video-stem>.silenced.mp4Das geschnittene Video (nur mit --apply)

Die auf stdout ausgegebene JSON-Zusammenfassung enthält removed, removedPct, Bereichszahlen und Ausgabepfade – nützlich für den Master-Workflow zur Protokollierung und Verkettung.

Abstimmungshinweise

  • Talking-Head-YouTube-Standard (--gap 0.55) entfernt typischerweise etwa 15-20 % einer Rohaufnahme als reine Stille. Niedrigeres --gap für einen knackigeren, schnelleren Schnitt; erhöhen, um mehr natürlichen Atemraum zu erhalten.
  • Wenn ein Schnitt an Satzgrenzen zu aggressiv wirkt, erhöhe die Atempause an Satzenden oder erhöhe --gap.

Übergabe an den nächsten Agenten

Übergebe <stem>.silence-transcript.json (und die silenced.mp4, falls gerendert) an den cut-mistakes-Agenten. Da die Zeitstempel bereits auf der bearbeiteten Zeitleiste liegen, funktionieren nachgelagerte Beat-Timing- und scripts/validate-beat-sync.mjs-Skripte ohne weitere Anpassung.

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.

Verwandte Skills