Communitygithub.com

nateherkai/hyperframes-student-kit

Planen, schreiben, timen, gestalten und validieren Sie Bewegtgrafiken für lange Videoprojekte mit HyperFrames – ideal für Codex, wenn es darum geht, visuelle Beats, Glassmorphism-Einblendungen, Notizen oder rendergerechte Overlays hinzuzufügen oder zu verbessern.

Was ist hyperframes-student-kit?

Diese Fähigkeit (Skill) unterstützt Entwickler dabei, für ein vorhandenes HyperFrames-Videoprojekt mit einem sprechenden Kopf (Talking-Head) ein durchdachtes und narrativ abgestimmtes Bewegtgrafik-Set zu erstellen. Sie hilft, das Video in visuelle Beats zu unterteilen, die die Zuschauer fesseln und die Kernbotschaften unterstreichen. Der Skill bietet eine strukturierte Vorgehensweise: Zunächst wird das Projektsetup (AGENTS.md, lokale Skill-Dokumente) und die Transkription analysiert, um Themenabschnitte zu identifizieren. Dann wird entschieden, ob ein Beat als großflächige Papier-Takeover, als transparente Glaskarte im unteren Drittel oder gar nicht benötigt wird. Das Timing wird präzise auf die gesprochenen Passagen abgestimmt, und die Texte werden für schnelles Erfassen optimiert. Der Skill legt Wert auf ein ernstes, professionelles Design mit schwarzem Text auf Papier und Akzentblau für wichtige Zahlen. Die Implementierung erfolgt streng nach den HyperFrames-Richtlinien, inklusive korrekter Attribute (data-start, data-duration) und Linting. Der Skill ist für Plattformen wie Codex konzipiert, die das HyperFrames-Ökosystem nutzen, und liefert rendergerechte Overlays sowie eine abschließende Validierung.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Video Beats

Nutze diesen Skill, um ein Talking-Head-Video mit Transkript in ein durchdachtes Set von Bewegtgrafiken zu verwandeln, die die Erzählung unterstützen, ohne den Sprecher unnötig zu überdecken.

Kernziel

Halte den Zuschauer orientiert und engagiert. Jeder Beat muss eine dieser Fragen beantworten:

  • Woran soll sich der Zuschauer erinnern?
  • Welches Konzept braucht eine visuelle Struktur?
  • Welche Statistik, welcher Kontrast oder Wendepunkt verdient Betonung?
  • Wo wird das Tempo so ruhig, dass der Zuschauer abdriften könnte?

Füge keine Grafiken nur hinzu, weil eine Lücke existiert. Füge Grafiken hinzu, weil die Erzählung ein Thema, einen Übergang, einen Beleg oder ein mentales Modell hat, das von visueller Unterstützung profitiert.

Erster Durchgang

  1. Lese die Projektanweisungen (AGENTS.md, lokale Skill-Dokumente und projektspezifische Notizen).
  2. Untersuche die Hauptkomposition, den aktuellen Beat-Zeitplan, das gemeinsame CSS und das Transkript.
  3. Erstelle eine Abdeckungskarte aus den data-start- / data-duration-Einträgen der Wurzel oder dem Master-Array SHOW.
  4. Extrahiere Transkript-Abschnitte für jede angefragte Region und alle ungedeckten Lücken.
  5. Identifiziere Themenspannen basierend auf der Erzählung, nicht auf willkürlichen Zeitstempeln.
  6. Entscheide, ob jedes Thema einen Vollbild-Papier-Beat, eine Glaskarte im unteren Drittel oder keinen neuen Beat benötigt.

Verwende schnelle lokale Befehle. Bevorzuge rg, Select-String und kleine Node-/PowerShell-Transkript-Skripte.

Beat-Typ Entscheidung

Vollbild-Knitterpapier verwenden

Verwende eine Papier-Takeover, wenn die Erzählung eine wichtige These, eine Liste, einen Abschnittsmarker, ein Zitat oder eine Statistik erreicht, die kurz das gesamte Bild einnehmen sollte.

Gute Anwendungsfälle:

  • Haken-Auszahlung oder „In diesem Video“-Übersicht
  • Großer Abschnittsübergang
  • Große Statistik oder Studienergebnis
  • Denkwürdige These
  • Kurzes Zitat oder Mantra
  • Kontrast, der das Publikum zum Anhalten und Hinsehen bringt

Regeln:

  • Halte es kurz, normalerweise 4-12 Sekunden.
  • Verwende sparsamen schwarzen Text.
  • Nur echte statistische Zahlen oder ein extrem wichtiges Wort dürfen eine Akzentfarbe erhalten.
  • Decke keine langen Erklärungen mit Papier-Takeovers ab.
  • Gestalte Vollbildtext nicht verspielt, riesig oder übermäßig fett.

Glassmorphism-Unterdrittel verwenden

Verwende ein Glas-Unterdrittel, wenn der Sprecher sichtbar bleiben soll und die Grafik die aktuelle Idee unterstützen soll.

Gute Anwendungsfälle:

  • Erklärungsgerüste
  • Themenlabels
  • Gleichungsartige mentale Modelle
  • Kleine Listen
  • „Was das bedeutet“-Übersetzungen
  • Tempofüller während langer Talking-Head-Passagen
  • Folgekarten nach einem verkürzten Vollbild- oder Split-Screen-Beat

Regeln:

  • Halte Unterdrittel im unteren Drittel oder der unteren Hälfte.
  • Vermeide es, das Gesicht zu überdecken.
  • Verwende präzisen Text: eine Überschrift plus optional kurze Unterzeile oder eine Liste mit 2-4 Punkten.
  • Bevorzuge eine Karte pro Themenspanne gegenüber vielen kleinen Blitzen.
  • Behalte den vorhandenen Stil der Glaskarte bei, es sei denn, der Benutzer bittet um eine Designänderung.

Tempofaustregeln

Für lange Talking-Head-Videos auf YouTube:

  • Frühes Video: vermeide mehr als 20-30 Sekunden ohne visuellen Beat.
  • Hauptteil: vermeide mehr als 30-45 Sekunden ohne Beat.
  • Dichte Erklärungsabschnitte: verwende Unterdrittel ungefähr pro Themenspanne, nicht pro Satz.
  • Große Papier-Takeovers sollten gelegentliche Satzzeichen sein, nicht die Regel.
  • Wenn ein bestehender Beat manuell verkürzt wurde, weil er zu lang erschien, respektiere diese Entscheidung und fülle danach mit einer neuen kürzeren Karte.

Wenn du einen Zeitplan durchgehst, melde echte Lücken aus dem Sichtbarkeitszeitplan, nicht nur aus der DOM-Reihenfolge. Wenn die Hauptzeitleiste ein SHOW-Array verwendet, ist dies normalerweise der maßgebliche sichtbare Bereich.

Timing-Methode

Times jeden Beat auf das Transkript-Thema ab:

  1. Finde das erste Wort oder den ersten Satz, an dem das Thema beginnt.
  2. Starte den Beat 0,2-0,6 Sekunden vor diesem Anker, wenn möglich.
  3. Halte den Beat sichtbar, bis das Thema endet oder natürlich übergeben wird.
  4. Wenn der nächste Beat sofort beginnt, räume 0,1-0,5 Sekunden davor, es sei denn, die Übergabe ist beabsichtigt.
  5. Stimme die Einblendungen von Unterelementen auf gesprochene Phrasen ab.

Vermeide diesen Fehlermodus:

  • Die Karte erscheint zum richtigen Thema, dauert aber nur 5-8 Sekunden, während der Sprecher das Thema 20-40 Sekunden lang weiter bespricht.

Bevorzuge:

  • Eine Karte lebt über das gesamte Thema hinweg, mit einer Unterzeile oder einem Listenelement, das in der Mitte aufgebaut wird, wenn sich die Erzählung weiterentwickelt.

Texterstellung

Schreibe für schnelles Erfassen. Der Zuschauer sollte die Karte in unter einer Sekunde verstehen.

Verwende:

  • Kurze Nominalphrasen
  • Direkte Labels
  • Ein mentales Modell pro Karte
  • Zahlen nur, wenn sie bedeutungsvoll sind
  • Verben, wenn sie die Handlung verdeutlichen

Vermeide:

  • Die gesamte Voiceover zu wiederholen
  • Lange Sätze
  • Vage Hype-Sprache
  • Zu viele hervorgehobene Wörter
  • Erklärungen, wie man das Video in der Grafik verwendet

Gute Muster:

Der Flaschenhals
Nicht genug KI in echten Arbeitsabläufen.
Das Problem ist die Adoption, nicht das rohe Talent.
Die Brücke
Fähigkeiten + Arbeitsabläufe = 40 Std gespart
In diesem Video
-> Die Studie
-> Die Statistiken
-> Die Wege, die du gehen kannst
-> Was wirklich zählt

Visuelle Stilregeln

Folge zuerst dem lokalen Designsystem. Für diese Projektfamilie verwende:

  • Seriöse professionelle Typografie.
  • Schwarzen Primärtext auf Papier-Beats.
  • Akzentblau nur für große Statistikzahlen oder seltene Machtwörter.
  • Glaskarten mit dem vorhandenen dunklen Frosted-Stil.
  • Unterdrittel-Karten, die das Gesicht des Sprechers nicht überdecken.

Für Papier-Beats:

  • Verwende Schwarz für Aufmacher, Labels, Pfeile, Quellen, Zitate und unterstützenden Text.
  • Halte die Schriftstärke zurückhaltend.
  • Vermeide übergroße verspielte Schriftarten, es sei denn, der Benutzer verlangt explizit danach.
  • Mache die Knitterpapier-Animation deterministisch.

Für Glaskarten:

  • Verwende .glass-card dim lower-third oder die nächstgelegene vorhandene Klasse wieder.
  • Bevorzuge Platzierung unten in der Mitte.
  • Halte Karten kompakt.
  • Verwende Gleichungs-/Listen-Helfer, wenn die Idee strukturell ist.

HyperFrames Implementierungsregeln

Folge der Projekt-AGENTS.md und den HyperFrames-Lint-Regeln:

  • Jedes montierte zeitgesteuerte Element benötigt data-start, data-duration und data-track-index.
  • Sichtbare zeitgesteuerte root-montierte Elemente sollten die erwartete Clip-/Layer-Klasse des Projekts haben.
  • Unterkompositionen sollten eine pausierte GSAP-Timeline unter window.__timelines registrieren.
  • Pinne jede Unterkompositions-Timeline mit tl.set({}, {}, SLOT);.
  • Verwende nur deterministische Logik.
  • Animieren Sie keine Videoelementabmessungen oder Media-Eigenschaften auf eine Weise, die Renders einfrieren kann.
  • Führe npx hyperframes lint nach dem Bearbeiten von HTML aus.

Beim Hinzufügen eines Beats:

  1. Erstelle compositions/beats/NNN-short-name.html.
  2. Füge die Root-Mount in index.html hinzu.
  3. Füge den Master-Sichtbarkeitszeitplan hinzu oder aktualisiere ihn, falls vorhanden.
  4. Stelle sicher, dass der SLOT der Unterkomposition mit der montierten Dauer übereinstimmt.
  5. Überprüfe, ob es keine Überlappungen auf demselben Track gibt, es sei denn, das Projekt verwendet absichtlich mehrere Overlay-Tracks.

Abdeckungsscan

Nach Bearbeitungen scanne den Master-Zeitplan:

  • Liste Beats sortiert nach sichtbarem Start.
  • Drucke Lücken über dem Zielschwellenwert.
  • Füge Beats nur hinzu oder timen sie neu, wenn das Transkript ein unterstützbares Konzept hat.

Verwende für dieses Projektmuster 30 Sekunden als strengen Scan-Schwellenwert und 45 Sekunden als maximal akzeptablen Hauptteil-Schwellenwert.

Validierung

Vor dem Abschluss:

  1. Führe den HyperFrames-Linter aus.
  2. Behebe alle Fehler.
  3. Erwähne Warnungen separat, wenn sie bekannt sind und nicht blockieren.
  4. Wenn der Benutzer rendergerechte Ausgabe verlangt, rendere oder mache einen Smoke-Render, je nach Bedarf.
  5. Gib dem Benutzer genaue Dateipfade und geänderte Zeitstempel an.

Praxisnahe Standardwerte

Verwende diese Standardwerte, falls der Projektkontext nichts anderes angibt:

  • Vollbild-Papier-Übersicht: 8-10 Sekunden.
  • Vollbild-Papier-Statistik: 5-8 Sekunden.
  • Glas-Unterdrittel-Erklärung: 12-30 Sekunden.
  • Lange Themen-Glaskarte: 25-45 Sekunden mit gestaffelten Unterelementen.
  • Beat-Start-Vorlauf: 0,2-0,6 Sekunden.
  • Lücken-Scan-Schwellenwert: 30 Sekunden.
  • Unterdrittel-Breite: etwa 68-72vw, maximal etwa 1240-1280px.

Was zu bewahren ist

Bewahre Benutzergeschmacksentscheidungen, die während der Überprüfung entdeckt wurden:

  • Wenn der Benutzer sagt, dass ein Beat zu lang ist, stelle ihn nicht wieder her, nur um eine generische Abdeckungsregel zu erfüllen.
  • Wenn der Glaskartenstil genehmigt ist, verwende ihn wieder, anstatt ihn neu zu designen.
  • Wenn die Typografie genehmigt ist, halte sie stabil und passe nur die lokale Größe/Schriftstärke an.
  • Wenn das Gesicht des Sprechers wichtig ist, bevorzuge Unterdrittel-Karten gegenüber Bildschirmmitte-Karten.

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

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/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