Communitygithub.com

viral-video-edits

Ein Komplettsystem zur Erstellung S-Tier-beat-synchroner Kurzmusikvideo-Edits – Songanalyse, Auswahl des viralen Fensters, Footage-Beschaffung mit Shot-Level-Qualitätsprüfung, Hook-Erstellung, Onset-gebundener Schnitt, integrierte audioreaktive Effekte (Person-Matten, prozedurale GLSL-Renderer, filmischer Look) und Auslieferungs-QA. Verwenden Sie dies immer dann, wenn der Benutzer ein Video-Edit, ein Musikvideo, einen Reel, ein TikTok/Shorts/Vertical-Video, einen beat-synchronen Zusammenschnitt, ein Lyrik-/Hook-Video, ein audioreaktives Visual, einen Tunnel/Portal/Kaleidoskop-Renderer oder die Bewerbung eines Songs mit Videoinhalten wünscht – selbst wenn er es nicht explizit sagt.

Was ist viral-video-edits?

Dieses Skill ist ein umfassendes, produktionserprobtes System zur Erstellung von hochwertigen, beat-synchronen Kurzmusikvideos, die sich für Plattformen wie TikTok, Instagram Reels und YouTube Shorts eignen. Es folgt zehn nicht verhandelbaren Gesetzen, die aus der realen Produktion und dem Kundenfeedback extrahiert wurden, und stellt sicher, dass jedes Video eine hohe Zuschauerbindung und Teilbarkeit erreicht. Das Skill behandelt den gesamten Workflow von der Songanalyse (Erkennung von Beats, Energie, Abschnitten) über die Footage-Beschaffung mit Qualitätsgattern, die Erstellung von Hooks, den onset-basierten Schnitt, die Integration von audioreaktiven Effekten (z.B. Person-Matten, prozedurale GLSL-Renderer) bis hin zur filmischen Farbkorrektur und der finalen Qualitätssicherung. Es ist plattformunabhängig, aber optimiert für den Einsatz mit CLI-Tools wie ffmpeg und Python-Skripten, die im Skill gebündelt sind und die Kern-Engines wie die Auswahl des viralen Fensters, die Shot-Qualitätsprüfung und den onset-basierten Schnitt implementieren. Das Skill ist für Entwickler und Content-Ersteller konzipiert, die konsistent professionelle und virale Musikvideoinhalte produzieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BusyBee3333/viral-video-edit-skills/tree/main/skills/viral-video-edits

In Ihrer bevorzugten KI fragen

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

Dokumentation

Viral Video Edits

Eine vollständige Methode zur Erstellung von perfekt beat-synchronen, effektintegrierten vertikalen Musikvideos, die wie S-Tier-Videografie wirken. Entwickelt aus einem funktionierenden Produktionssystem (der Kurzvideo-Promotion-Kampagne eines unabhängigen Musikers) und dem daraus gesammelten Kundenfeedback. Die einzige Erfolgskennzahl ist die Performance (Bindung + Shares), und jede der folgenden Regeln existiert, weil ihre Verletzung in der Praxis als Fehler beobachtet wurde.

Die Gesetze (nicht verhandelbar; jedes wurde auf die harte Tour gelernt)

  1. Nur integrierte Effekte. Effekte werden IN Aufnahmen verschmolzen – an die Maske des Subjekts, an die Szenengeometrie oder an die eigenen Pixel der Aufnahme. Niemals zu eigenständigen FX-Segmenten wegschneiden; niemals Vollbild-FX mit Vollbild-Material abwechseln; ein nicht getracktes compositiertes Element wirkt wie ein Aufkleber. Lies references/integrated-fx.md, bevor du einen Effekt hinzufügst.
  2. Gut aussehen ist wichtiger als Parameter zu befolgen. Wenn das angeforderte Material oder die Struktur die Qualität beeinträchtigt, ändere die Struktur und sage dies. Viele zusammenhangslose Clips, die an Beat-Grenzen aneinandergenäht werden, wirken selbst mit einem gemeinsamen Motiv chaotisch.
  3. Reichhaltig, nicht zurückhaltend – und nicht kitschig. Der Arbeitsbereich ist ein REICHER, dichter Look (echte Schwarzen, Kontrast-S-Kurve, festgelegte Palette) + EIN harter Realitätsknick pro Aufnahme auf dem Beat-Raster. Pure Zurückhaltung wirkt ausgewaschen und langweilig; willkürliche einmalige Effekte pro Aufnahme wirken chaotisch. Eine Effektsprache pro Schnitt, gesteigert mit der Songstruktur.
  4. Schneide nach dem, was der Song hergibt. Onset-gebundener Schnitt: ein Schnitt auf jedem echten Onset (unter 0,13s fusioniert, wobei der stärkere bleibt), Halten bei spärlichen, Ausbrüche bei dichten Stellen – niemals Off-Grid-Füllschnitte, niemals eine Dichtevorgabe, die den Song überschreibt. Für Share-Lane-Stücke der entgegengesetzte Pol: eine durchgehende Aufnahme, null Schnitte, photometrische Transformation, angetrieben von den Hüllkurven des Songs.
  5. Synchronisation durch Konstruktion. Alle FX-Renderings werden gegen das exakt gleiche Fenster (--start/--dur) und die gleiche Schnittliste wie das Edit erzeugt. Geschätzte Beats an reale erkannte Onsets anpassen (≤60ms). Stilwechsel landen auf dem Frame, der DEN Transienten enthält (floor, nicht round).
  6. Fast-schwarz + emissiv für alle prozeduralen Bilder. Ausgewaschene Pastellflächen versagen jedes Mal; Licht muss aus der Dunkelheit herausgearbeitet werden.
  7. Hooks bestehen das 5-Test-Tor (Blick/Sprechen/Name/Lücke/Zug, ≥4 von 5). Keine Poesie, kein "niemand:", keine Engagement-Köder-Befehle. Siehe references/hooks-and-text.md.
  8. Footage-Gatter auf Aufnahmeebene. Vibe-Spezifikation vor der Beschaffung; zuerst die höchsten Quellen; Qualitätsgatter pro Aufnahme + menschlicher Kontaktbogen-Blick; nur akzeptierte Aufnahmen kommen in Edits. Lizenz pro Datei prüfen. Siehe references/footage-sourcing.md.
  9. Automatisierte QA ersetzt nie das Anschauen. Jedes Auslieferungsergebnis erhält einen Probe-Bericht UND einen Blick auf den Kontaktbogen und das vollständige Rendering bei normaler Geschwindigkeit und in Telefongröße. Siehe references/delivery-qa.md.
  10. Iteriere als nummerierte Versionen auf stabiler Infrastruktur. Ändere nur die Effektsprache zwischen den Versionen; wenn der Kunde einen 2-Sekunden-Moment liebt, mache diesen Moment zur gesamten Sprache der nächsten Version.

Hausformat

1080×1920 @ 30fps vertikal, libx264 yuv420p +faststart, aac 192k, CRF 17 (Frame-Pipe-Finale) / 18–19 (Segment-Finale). Nahtlose Loop-Enden. Versionierte Dateinamen unter outputs/<project>/. Jedes Edit wird mit einem Kontaktbogen + Timeline-Datei + QA-Bericht ausgeliefert.

Der Arbeitsablauf

Schreibe bei allem nicht Trivialen zuerst den Plan auf (Design-Dokument / Aufnahme-für-Aufnahme-Plan – references/design-docs.md), und führe bei einer neuen Kampagne einen Piloten durch: V1 beweist die Grammatik, Freigabe ermöglicht den Batch.

  1. Analysiere den Song → Beat-Raster, Energie/Schnittpriorität pro Beat, Abschnitte, 8-Beat-Phrasen. Dann wähle das Fenster (15–30s) nach Wiederholung (Chorus-Charakter), Energieanstieg, Loop-Naht, Lyrikplatzierung, bisheriger Künstler. → references/song-analysis.md
  2. Beschaffe und prüfe Footage → Vibe-Spezifikation, gestufte Quellen, Qualitätsgatter pro Aufnahme in eine Shot-Map, semantische Vertragsprüfungen, wenn das Konzept bestimmte Inhalte erfordert. → references/footage-sourcing.md
  3. Schreibe das Hook-Paket → 5-Test-Tor, Zweite-Zeile-Drop-Kinetik (Zeile 1 bei Frame 0, Zeile 2 beat-gebunden bei 0,8–1,3s ±100ms), A/B-Paket auf der Achse warm-lustig vs. ruhig-spezifisch. → references/hooks-and-text.md
  4. Baue den Schnitt → Wähle die Taktung (Beats-CSV für musikalische Takte; Onset-Raster für Transienten-Schnitt), erstelle den Aufnahmeplan in Beats, setze strukturelle Anker (Drop auf seinem Takt ±0,02s). Architektur: Segment→concat→Post-Graph (nur ffmpeg) für schnittgetriebene Edits; Frame-Pipe numpy für Pixel-für-Pixel-Effekte; In-Shader-Fusion für die tiefste Integration. → references/integrated-fx.md
  5. Integriere Effekte → Person-Matten (Apple Vision, qualitätsgeprüft), matten-/szenen-/pixelverankerte Effekte, die bewährte base.mp4→matten→effects-table-Pipeline; prozedurale Elemente, die im selben Fenster gerendert und über Szenengeometrie eingebracht werden. → references/integrated-fx.md, references/procedural-renderers.md
  6. Grading & Craft-Layer → Das exakte filmische Rezept (Halation, ACES, Split-Tone, Korn, Vignette, Letterbox), matten-zentroidische Einzoomer, Eskalationsspirale, Loop-Naht. → references/cinematic-grade.md
  7. QA & Auslieferung → Günstigen Proof der ersten 3–5s früh erstellen; Probe + Kontaktbogen + ansehen; Kohäsionsprüfung (jeder Sticker-Look oder Cutaway = Revision); Varianten mit Manifest + Galerie paketieren; Beiträge in die Experimentier-Schleife protokollieren. → references/delivery-qa.md

Die richtige Spur wählen

FrageSpur
Emotionaler/lyrischer Track, share-fokussiertEine durchgehende Aufnahme + photometrische Transformation (Grade-Rampe, Lichtankunft, Bloom) angetrieben von Song-Hüllkurven; Affirmation-Identität-Hook
Energie-Track, bindungsfokussiertOnset-gebundener schneller Schnitt aus einem tiefen, geprüften Shot-Pool (60+ Aufnahmen), Punch-In-Akzente auf den oberen Quartil-Onsets
Künstler-im-Bild-ShowcaseFilmischer Craft-Layer + ein mattenverankerter Signature-Effekt pro Aufnahme (Stil-Flicker, Echo-Klone, Subjekt↔Welt-Tausch, Beat-Stamp-Menge)
Abstrakter/visueller KnallerProzeduraler GLSL-Renderer (Tunnel/Kaleido/Starburst), fast-schwarz + emissiv, Onsets→Punch-Bass→Bloom-Energie→Speed; mit Footage durch In-Shader-Weave fusionieren, wenn es ein Subjekt gibt
Hero-Titel/MarkenstückDesign-Doc zuerst; phasenbasierte Motion-Timeline; TDD-Build; vergleichender visueller Audit gegen Referenzen

Referenzen (bei Bedarf lesen)

  • references/song-analysis.md — Analyse-Formeln, Viral-Window-Bewertung, Onset-Raster, Beat-Mathematik, Hüllkurven-Folger. Lies dies, wenn du einen neuen Song beginnst oder Sync-Probleme behebst.
  • references/integrated-fx.md — DIE zentrale Craft-Doktrin: Verankerungsregeln, Fehlermodi, Matten-Pipeline, drei Build-Architekturen, Compositing-Fallstricke (Screen-Blend in RGB!), Subjekt-Effekt-Vokabular. Lies dies vor jeder FX-Arbeit.
  • references/procedural-renderers.md — moderngl-Skelett, GLSL-Hausbibliothek, Hausfarbe-Finish, Fast-Schwarz-Gesetz, Portal-Weave-Fusion, TouchDesigner-Spur. Lies dies, wenn du prozedurale Visuals renderst.
  • references/cinematic-grade.md — Das exakte Grading-Rezept, Kamerasprache, Eskalationsspirale und die Iterations-Fallstudien (dreamcatcher v1→v5, with-u v4→v7, the portal arc). Lies dies, wenn das Edit wie Kino wirken muss, oder vor dem Iterieren einer Version.
  • references/hooks-and-text.md — 5-Test-Tor, Containerformat, Text-Kinetik, Turniermethode, Feldreferenzen, Optimierungsschleife. Lies dies, wenn du On-Video-Text schreibst oder zwischen kreativen Ansätzen wählst.
  • references/footage-sourcing.md — Vibe-Spezifikationen, Quellstufen, exakte Gatter-Schwellen, Lizenzierung, semantische Verträge, Matten-Paar-Verträge. Lies dies vor der Beschaffung oder Zulassung von Footage.
  • references/delivery-qa.md — Encode-Einstellungen, Auslieferungsergebnisse, QA-Durchlauf, Urteilsformat, Veröffentlichungspaket. Lies dies, bevor du etwas als fertig bezeichnest.
  • references/design-docs.md — Ideenblatt → Plan → Design-Dokument → Planmuster. Lies dies, wenn du eine neue Produktion oder Kampagne planst.

Gebündelte Skripte (ausführbar, nicht nur beschrieben)

Dies sind funktionierende Implementierungen der Kern-Engines – greife zu ihnen, bevor du neue von Grund auf schreibst. Alle sind einfache CLI-Tools; führe --help aus oder lies den Docstring am Anfang jeder Datei.

  • scripts/choose_viral_window.py — Auswahl des viralen Fensters (song-analysis.md §2). --audio song.wav [--transcript whisper.json] [--tiktok-start SEC] [--durations 15,22,30] --out DIR.
  • scripts/scan_shot_quality.py — Das Qualitätsgatter für Footage auf Aufnahmeebene (footage-sourcing.md). --root path/to/footage [--min-shot 1.2] [--jobs 3] → schreibt shot_map.json. Benötigt opencv-python, scenedetect, pytesseract.
  • scripts/build_onset_cut.py — Die onset-gebundene v2-Schnitt-Engine (song-analysis.md §3, integrated-fx.md Architektur A). --config job.json [--shot-map shot_map.json]; siehe den Docstring für das Job-Schema.
  • scripts/matte/generate_local_person_matte.swift — Frame-für-Frame-Personen-Matten mittels Apple Vision (integrated-fx.md). Mit swiftc generate_local_person_matte.swift -O -framework AVFoundation -framework Vision -framework CoreImage -framework ImageIO -o mattegen kompilieren (macOS 14+), dann mattegen source.mp4 proposal_dir/ ausführen.
  • scripts/matte/media_contract.py — Die Implementierung des Matten-Qualitätsgatters (validate_matte_statistics, matte_statistics, probe_media, validate_sync) – die exakten Schwellenwerte aus integrated-fx.md als Code, nicht nur als Prosa.
  • scripts/procedural/ — 10 eigenständige moderngl/GLSL-Renderer (render_color_tunnel.py, render_glass_bloom.py, render_mandala.py, render_fractal_neon.py, render_shader_pack.py, render_neon_cathedral.py, render_dream_portal.py, render_hyper_space_jump.py, render_hyper_kaleido.py, render_portal_weave.py) plus footage_fx.py (Ganzbild-FX auf echtem Footage) und subject_fx.py (mattenverankerter FX-Sampler) – siehe procedural-renderers.md. Jedes akzeptiert --audio --start --dur --out [--fps 30 --w 1080 --h 1920]; mehrere unterstützen auch --still für schnelle Art-Direction-Prüfungen. Benötigt moderngl, librosa, numpy, Pillow.

Song-Analyse (script/analyze_song_for_editing.py, der Beats/Abschnitte/Energie-Produzent) ist hier nicht gebündelt – verwende das äquivalente Skript, das bereits im Companion-Skill song-edit-analysis (gleiches Kit) gebündelt ist, oder implementiere es neu aus song-analysis.md §1.

Arbeiten im Heim-Repository

Wenn dieses Skill im ursprünglichen Produktions-Workspace läuft, aus dem es extrahiert wurde, bevorzuge die eigenen Kopien dieser Skripte aus diesem Repository (sie könnten Fehlerbehebungen enthalten) sowie dessen Batch-/Beschaffungsinfrastruktur (Job-Generatoren, Galerie-Builder, die Posting-Experimentier-Schleife) gegenüber den gebündelten Versionen. Woanders – was der übliche Fall für dieses öffentliche Skill ist – sind die gebündelten scripts/ die vollständigen Implementierungen; die Referenzdokumente enthalten jede tragende Konstante, die zum Erweitern oder Neuimplementieren benötigt wird.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

beat-synced-montage-builder

Build beat-synced social video montages from song-analysis outputs and source footage. Use when an agent needs to assemble, plan, or revise a music-timed edit; map footage to beats/onsets/cut markers; create vertical or landscape montage timelines; integrate audio-reactive FX into shots; mix gameplay, crowd, concert, nature, menu, or other accent footage; generate timeline CSVs, contact sheets, and edit briefs; or adapt the Conteto Machino / Smash Mash workflow for another song or footage library.

edit-delivery-qa

Verify final video edits before delivery. Use when an agent needs to inspect a rendered MP4/MOV/WebM, confirm duration/resolution/frame rate/audio, generate or review contact sheets, analyze timeline CSVs, check cut density/source mix, check FX integration and cohesion, verify text-to-beat sync, catch weak frames or accidental placeholders, and decide whether a beat-synced social edit is ready to show.

generated-media-sourcing

Generate or plan media assets for beat-synced edits when real footage is missing or the user asks for generated visuals - AI video (Gemini/Veo/Flow), AI images, or procedural audio-reactive GPU renders (tunnels, portals, kaleidoscopes, starbursts, mandalas, title pieces via Python+moderngl GLSL). Use with beat-synced-montage-builder when a montage needs generated clips, stills, or procedural audio-reactive elements instead of, or alongside, sourced footage.

song-edit-analysis

Analyze songs and audio files for beat-synced video editing, clip timing, energy mapping, viral window selection, onset-locked cut grids, footage selection, and agent-readable edit briefs. Use when an agent needs to inspect an MP3/WAV/M4A/audio track, estimate tempo and beat grids, identify sections, produce cut markers, pick the best 15-30s window of a song for short-form video, or guide a human or another agent in choosing footage that matches musical energy.

Verwandte Skills