Communitygithub.com

CrissAlvarezH/video-script

Kurze Video-Skripte schreiben, die Zuschauer fesseln – basierend auf den eigenen Video-Analysen des Creators. Verwende es, um den Hook einer gewählten Idee zu bestimmen, ein Skript vor dem Dreh zu verfassen oder zu straffen (Talking-Head oder erklärendes Voiceover) oder um Erkenntnisse aus einem veröffentlichten Video in Lektionen umzuwandeln.

Was ist video-script?

Dieses Skill hilft dabei, kurze Video-Skripte zu erstellen, die Zuschauer binden, indem es auf den tatsächlichen Leistungsdaten des Creators (z. B. aus YouTube- oder TikTok-Analysen) und nicht auf Bauchgefühl basiert. Es behandelt die gesamte Pipeline: vom Finden eines starken Hooks und der Aufrechterhaltung der Neugier über die Strukturierung von Erklärvideos bis zur Analyse bereits veröffentlichter Videos, um datengestützte Verbesserungen abzuleiten. Es unterstützt Inhaltsersteller, die Skripte für kurze Formate (Talking-Head, erklärendes Voiceover) schreiben und ihre Arbeit mit echten Metriken validieren möchten. Die Hauptaufgaben sind "Skript" (Erstellung eines neuen Drehbuchs) und "Review" (Analyse eines veröffentlichten Videos). Das Skill legt großen Wert darauf, Aussagen durch Daten zu belegen, die Haltefaktoren mit präzisen Zeitstempeln einzubinden und nach jeder Skriptversion eine Faktenprüfung durchzuführen. Es ist als Teil eines Ökosystems mit anderen Skills wie "content-ideas" (Ideenfindung), "video-edit" (Schnitt) und "animated-video" (Animation) konzipiert und bietet klare Schnittstellen zwischen diesen Funktionen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CrissAlvarezH/ai-reel-gen-app/tree/HEAD/.claude/skills/video-script

In Ihrer bevorzugten KI fragen

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

Dokumentation

Video-Skript

Ein kurzes Video wird größtenteils vor dem Dreh entschieden – durch drei Entscheidungen: den Einsatz (wer, außerhalb der eingeweihten Gruppe, hat einen Grund, sich dafür zu interessieren), die ersten beiden Sätze (warum weiterschauen) und den Beweis (was der Zuschauer sieht, das die Behauptung real macht). Triff jede Entscheidung auf Basis von Beweisen: zuerst die eigenen früheren Videos des Creators, dann die Angaben der Plattform, zuletzt der persönliche Geschmack.

Worauf der Zuschauer schaut, ist die Antwort auf eine Frage. Neugier hält sie, und jede Antwort gibt ihnen einen Grund zu gehen. Ein Skript ist also ein Gleichgewicht zwischen beidem: Stelle früh eine Frage, und schließe sie erst, wenn eine andere geöffnet ist.

Einrichtung

SKILL_DIR bezeichnet den Ordner dieses Skills. Falls vorhanden, lies ~/.video-script/profile.md ein: es benennt die Videobibliothek des Creators, die Ergebnisdatei, Plattformnotizen, Stimme und Tempo. Bevor du etwas vorschlägst, lies die Ergebnisdatei (einschließlich noch laufender Tests) und den Bibliotheksindex und zitiere die vergangenen Videos, an die eine Idee erinnert. Wo die Ergebnisse mit einer der untenstehenden Standardvorgaben in Konflikt stehen, haben die Ergebnisse Vorrang: sie wurden an diesem Publikum gemessen.

Ohne Profil frage einmal nach der Plattform, dem Publikum und einem vergangenen Video, das gut lief, sowie einem, das nicht gut lief – mit deren Zahlen. Biete dann an, ein Profil und eine Bibliothek im Bibliotheksformat zu erstellen.

Ziel bezeichnet das, wofür ein Video gemacht ist: Reichweite (Aufrufe von Nicht-Abonnenten), Follower, Speicherungen oder Shares. Wenn die Anfrage kein Ziel benennt, nimm Reichweite an und sage dies.

Die Aufgaben hier sind Skript und Review eines veröffentlichten Videos; Ideen gehen an content-ideas. Dieses Skill endet bei einem Skript oder einer Lektion: Das Filmen obliegt dem Creator, den Schnitt erledigt video-edit, die Animation animated-video.

Ideen

Ideen finden und speichern ist Aufgabe von content-ideas. Wenn ein Skript von einer Idee ausgeht, stehen in deren Notizen bereits der Hook, die Frage, die er öffnet, was zurückgehalten wird und der Beweis: Beginne damit und überprüfe sie an der Quelle, bevor du dich auf sie verlässt.

Skript

Formuliere die Idee in einem Satz, mit ihrem Ziel. Eine Idee, die zwei Sätze braucht, sind zwei Videos; frage, welches zuerst gemacht werden soll.

Finde den Lohn und den stärksten Beweis vor dem Hook, dann schreibe den Hook in zwei Teilen: das Thema als das Ergebnis formuliert, das dieses Publikum möchte, in seinen eigenen Worten über sein Problem, dann die überraschendste wahre Behauptung oder der stärkste Beweis, den du hast, die eine Frage öffnet, die der Zuschauer in Worte fassen könnte. Nenne das Subjekt nicht, wenn das Nennen die Frage beantworten würde. Schreibe im Tempo des Creators (aus dem Profil; Standard 3 gesprochene Wörter pro Sekunde). Drei Momente sind an die Uhr gebunden, und der Abschnitt dazwischen folgt einer Regel; der Rest nimmt die eigene Form der Geschichte an:

  • 0–3 s, der Hook: über den Einsatz des Zuschauers oder das, was auf dem Bildschirm zu sehen ist. Referenzen kommen später, als Grund zu glauben; ein Ergebnis, das der Zuschauer will, zählt als Einsatz, wenn es die Frage öffnet.
  • 3–10 s, der zweite Satz: erhöht den Einsatz des Hooks oder schärft seine Frage, ohne sie zu beantworten. Die meisten vermeidbaren Verluste passieren hier, also wartet der Hintergrund. Hintergrund ist alles, was der Zuschauer nur braucht, um einem späteren Detail zu folgen (Geschichte, wer jemand ist, wie etwas funktioniert); der Test: Wenn das Verschieben einer Zeile hinter 15 s in den ersten 15 s nichts verliert, ist es Hintergrund.
  • Dazwischen wird die Antwort zurückgehalten: der Lohn ist nicht ein einziger Moment. Nenne die Linie, die die Frage des Hooks schließt, oft ein Begriff, den der Zuschauer erkennt: Sobald sie ihn hören, denken sie, sie wüssten den Rest. Davor kommt das, was dorthin führt und für sich allein hörenswert ist: was die meisten falsch machen, was es sie kostet, warum die offensichtlichen Alternativen versagen. Wenn es endlich gesagt wird, öffnet derselbe Atemzug eine neue Frage, etwas darüber, das sie noch nicht gehört haben. Zurückhalten bedeutet, ihnen in der Zwischenzeit etwas anderes zu geben; eine Zeile, die nur neckt oder sagt "bleib bis zum Ende", ist kein Zurückhalten, sondern Füllmaterial.
  • Das Ende: der endgültige Lohn, das Versprechen des Hooks auf dem Bildschirm gezeigt, dann höchstens ein kurzer Call-to-Action. Alles nach dem Lohn spielt vor einem gehenden Publikum.

Für einen Erklärer (wie etwas funktioniert), lies explainers vor dem Verfassen.

Neben jede Zeile schreibe, was der Zuschauer sieht und welche Aufnahme es braucht (Bildschirmaufnahme, Dokument, die echte Person oder das Produkt). Eine Zeile, die niemand zeichnen könnte, ist eine, die der Zuschauer im Kopf behalten muss. Für einen animierten Film ist diese Spalte ein Hinweis an animated-video, das die Welt gestaltet.

Liefere und speichere, wo das Profil es sagt: das Skript als Zeit, gesprochene Zeile und Bildschirmbild; die Aufnahmeliste; einen Entwurf der Bildunterschrift mit den Einschränkungen und Links, die das gesprochene Skript nicht enthalten kann, deren Eröffnung die Frage des Hooks aufwirft statt sie zu beantworten; die geschätzte Laufzeit; alternative Hooks, jeder mit seinem eigenen zweiten Satz, wenn der Einstieg noch offen ist; und die zu überprüfenden Behauptungen mit Quellen (markiere jede Quelle, die du nicht öffnen konntest). Lass einen frischen Agenten jede Behauptung im Wortlaut des Skripts gegen ihre Quelle prüfen: Recherche, die richtig ist, kann im Skript dennoch übertrieben sein.

Wenn der Creator einige Zeilen umschreibt, übertrage die stilistischen Unterschiede auf die Zeilen, die du noch besitzt. Behalte ihre Formulierung bei, es sei denn, du wirst gebeten, sie zu bearbeiten, und weise separat auf faktische Probleme darin hin.

Checkliste

Halte das Skript gegen diese Punkte, die Ergebnisdatei und die Plattformnotizen, bevor du es lieferst:

  • Eine Idee. Eine Liste verdient ihren Platz nur, wenn jedes Element diese Idee beweist.
  • Der Einsatz ist dadurch gerahmt, wen er betrifft und was sie wollen, in Worten, die ein Nicht-Experte versteht. Werkzeugnamen und Fachjargon kommen erst, wenn der Zuschauer einen Grund hat, sich zu kümmern.
  • Lies als Zuschauer: Frage bei jeder Zeile, ob du jetzt das Gefühl hättest, die Antwort zu kennen und zu gehen. Wenn ja vor dem geplanten Punkt, verschiebe die Zeile oder öffne die nächste Frage dort. Sage, was die Frage des Hooks schließt und wann.
  • Jede Behauptung wird gezeigt. Stimme, Untertitel und Bildschirm geben dieselbe Zahl.
  • Jedes Versprechen im Hook wird auf dem Bildschirm eingelöst.
  • Jeder Satz, für sich genommen, sagt, wer wem was antut und wohin ein Ergebnis geht. Ersetze ausgelassene Objekte und mehrdeutige Verweise durch das Substantiv; behalte Pronomen, deren Bezug klar ist. Überarbeitungen brechen dies, also überprüfe nach jeder erneut.
  • Die Zeilen sind vollständige, zusammenhängende Sätze in der Stimme des Creators (der von Profil genannte Stimmleitfaden), die leicht laut auszusprechen sind. Eine Zeile, die so kurz geschnitten ist, dass sie eine Frage aufwirft ("die vollständige Route" wovon?), kostet mehr als die Sekunden, die sie spart.
  • Jede Zeile bewegt die Geschichte voran (eine Zeile, die die vorherige wiederholt oder ankündigt, was kommt, tut das nicht), und die Laufzeit ist so kurz, wie es die Geschichte erlaubt.

Ein veröffentlichtes Video reviewen

  • Notiere jede Zahl: Aufrufe, Zuschauer, durchschnittliche Sehdauer, Follower, Interaktionszahlen, jede Rate mit ihrer Bezeichnung, Aufrufe nach Quelle und die Bindungskurve mit ihrer Dauer (Insights lesen). Lies aus einem Screenshot die Kurve mit python3 SKILL_DIR/scripts/retention_curve.py SHOT --duration SEKUNDEN aus und überprüfe ihren flächenbasierten Durchschnitt anhand der Angabe der App. Identifiziere jedes Screenshot-Video anhand seines Thumbnails, der Diagrammdaten und der Aufrufzahl; frage nach, wenn diese Beweise keine Entscheidung zulassen.
  • Gleiche die Kurve mit den Untertiteln des endgültigen Renders ab: Notiere bei jedem Abfall und Plateau, was in den Sekunden davor gesagt und gezeigt wurde. Vergleiche mit der Bibliothek: Videos im selben Format und den 3→10-s-Abfall jedes Videos.
  • Nenne die nächste Version, wenn es eine gibt, die es wert ist, gemacht zu werden: die kleinste Änderung, die das Gefundene adressiert, wie ein neuer Hook oder ein Schnitt, wo Leute gegangen sind, oder was ein Video, das die anderen übertroffen hat, anders gemacht hat und wie man es wiederholt.
  • Schreibe den Bibliothekseintrag des Videos und die Indexzeile, dann aktualisiere die Ergebnisdatei: füge die Beweise zu jeder Hypothese hinzu, die sie betreffen, und ändere einen Status nur, wenn zwei oder mehr Videos übereinstimmen. Bevor du speicherst, nimm jedes zitierte Wort und jede Zeit aus der Untertiteldatei, nicht aus einer Zusammenfassung; gib ein Veröffentlichungsdatum nur mit seiner Quelle; überprüfe jedes Rangwort (höchste, niedrigste, einzige, beste) anhand des Index, eingegrenzt auf die Videos, die es abdeckt.

Individual skills in this repo

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

CrissAlvarezH/animated-video

Make animated videos in code with Remotion (React, SVG, three.js): explainers, character stories, motion graphics, kinetic typography, paper collage and animated infographics, in 2D or 3D, from a script or voiceover, in any aspect ratio. Use when asked to animate a script, make an animated video or Reel, or motion graphics. Not for editing camera footage (video-edit) or AI-generated clips (higgsfield-*).

CrissAlvarezH/new-style

Create a new visual style for the creator's videos in a Reel Studio workspace (styles/<id>/style.json): interview him for its name, feel, colours and what each one means, fonts, motion, where pictures come from, reference links and images, then write the style so it shows in Estilos and new videos can use it. Use when he asks for a new style or presses "Nuevo estilo" on the Estilos page.

CrissAlvarezH/persona-hablando

The "Persona hablando + animaciones" format of a Reel Studio video — the creator talks to camera in his own recording; you transcribe it, agree the cuts with him (pauses, flubs, retakes), cut it, and lay the video's style animations over or between his shots. Use for any video whose format.txt says persona-hablando.

CrissAlvarezH/reel-studio

How a narrated explainer video is made in a Reel Studio workspace, in any visual style — script, pictures, voice, images, build, board, sound, mute test, render — following the creator's settings from the studio (profile, format, voice, image sources). Use for any new or revised video in a project's videos/ (projects/<id>/videos/). The video's style adds its own skill (styles/<id>/SKILL.md) for the look and the Remotion kit; LESSONS.md has what past videos taught.

Verwandte Skills