Communitygithub.com

Skript für langes Video

Verständige dich über die Geschichte für ein langes Video. Der Nutzer liefert entweder eine Geschichte oder lässt Claude eine schreiben. Wenn Claude schreibt, fragt es zuerst nach dem Stil, führt die entsprechende Fähigkeit aus und überarbeitet, bis der Nutzer zustimmt. Verwende nach long-video-setup oder wenn der Nutzer „Geschichte für mein Video“, „gib mir eine Idee“ sagt oder eine nicht genehmigte Geschichte ändern möchte. Endet nur, wenn der Nutzer die Geschichte ausdrücklich genehmigt.

Was ist Skript für langes Video?

Diese Fähigkeit (`long-video-story`) ist der zweite Schritt im Workflow für lange Videos und hat das Ziel, eine genehmigte `story.md` im Projektordner zu erstellen. Sie wird aktiviert, nachdem `long-video-setup` ausgeführt wurde, oder wenn der Nutzer eine Idee, Änderungen oder eine eigene Geschichte einbringt. Der Skill unterstützt drei Szenarien: Der Nutzer hat eine fertige Geschichte, eine grobe Idee oder möchte, dass Claude die Geschichte schreibt. Im letzteren Fall fragt der Skill immer zuerst nach einem gewünschten Erzählstil (z. B. Nischenfindung oder provokative Fragen) aus einer Liste installierter Stil-Fähigkeiten. Falls kein passender Stil existiert, kann der Nutzer einen offenen Stil wählen, bei dem Claude selbstständig Ideen entwickelt, skizziert und die Geschichte in einer vorgegebenen Gliederung (Titel, Logline, Hook, Handlungsbogen, vollständiger Text, Faktenprüfung) ausarbeitet. Der gesamte Prozess endet erst mit einer ausdrücklichen Genehmigung durch den Nutzer; erst dann wird die Geschichte auf „approved“ gesetzt und der nächste Schritt (`long-video-assets`) kann beginnen. Der Skill ist für Claude Code und andere KI-Agenten konzipiert, die mit einem definierten Projektverzeichnis und Konfigurationsdateien arbeiten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samanfirouzi/long-video-skill/tree/HEAD/skills/long-video-story

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Skript für langes Video?

Stufe 2 des Workflows für lange Videos. Ergebnis: eine genehmigte story.md im Projektordner.

Diese Stufe endet erst, wenn Claude und der Nutzer sich auf die Geschichte geeinigt haben. Keine spätere Stufe beginnt davor.

Vorbereitung

  1. Finde das aktive Projekt: ~/.long-video/projects/<slug>/project.json. Hat der Nutzer mehrere, frage nach.
  2. Wenn kein Projekt existiert, führe zuerst long-video-setup aus.
  3. Lade die Konfiguration des Projekts aus ~/.long-video/configs/<config-name>.json. Verwende sie für Länge, Sprache, Zielgruppe, Ton, Format und visuelle Umsetzung. Frage nicht erneut, was die Konfiguration bereits beantwortet.
  4. Wenn story.md bereits mit Status draft existiert, biete an, sie fortzusetzen. Wenn der Status approved ist, frage, ob sie wieder geöffnet werden soll.

Schritt 1: Die Eingangsfrage stellen

Frage: „Hast du eine Geschichte, oder soll ich dir eine schreiben?“

  • Ich habe eine Geschichte. Der Nutzer fügt sie ein oder beschreibt sie. Gehe zu Schritt 5.
  • Schreib mir eine. Gehe zu Schritt 2.
  • Ich habe eine grobe Idee. Der Nutzer gibt einen Ansatz (Thema, Motiv, einen Satz). Behalte ihn, dann gehe zu Schritt 2.

Schritt 2: Nach dem Erzählstil fragen

Frage immer danach, wenn Claude die Geschichte schreibt. Überspringe das nicht und wähle keinen Stil für den Nutzer aus.

  1. Lies references/story-styles.md. Prüfe, welche Stil-Fähigkeiten installiert sind.
  2. Zeige die verfügbaren Stile an, jeweils mit ihrer einzeiligen Beschreibung. Gib immer open an.
  3. Bitte den Nutzer, einen auszuwählen. Sie können auch ihren eigenen Stil beschreiben. Falls ja, behandle es als open mit ihrer Beschreibung als zusätzliche Anweisungen.
  4. Speichere die Wahl in project.json als "story_style": "<id>".

Schritt 3: Thema finden

Folge dem Typ des gewählten Stils.

  • Ideas (z. B. niche): Rufe die Stil-Fähigkeit auf. Übergib die Zusammenfassung der Konfiguration und etwaige Ansätze. Sie gibt ein Thema zurück. Frage dann, welcher Schreiber verwendet werden soll (Paarungsregel aus Schritt 4 im Registry).
  • Writer (z. B. questions): Wenn der Nutzer ein Thema oder einen Ansatz hat, verwende es. Wenn nicht, frage danach. Schlage keine Themen vor.
  • open: Skizziere Ideen, wie unten beschrieben.

Offener Stil: Ideen skizzieren

  1. Wenn es keinen Ansatz gibt, stelle maximal 3 kurze Fragen: Themenbereich oder Interessen, etwas, das vermieden werden soll, echte Ereignisse oder Quellen, die verwendet werden können.
  2. Schreibe 4 Vorschläge, die zur Konfiguration passen. Jeder Vorschlag hat: Titel, einzeilige Logline, die ersten 15 Sekunden als Aufhänger und warum es für dieses Publikum funktioniert.
  3. Gestalte die 4 Vorschläge deutlich unterschiedlich voneinander.
  4. Frage den Nutzer, ob er einen auswählen, zwei kombinieren, weitere wünschen oder eine neue Richtung vorgeben möchte. Wiederhole, bis der Nutzer sich entscheidet.

Schritt 4: Die Geschichte schreiben

Rufe den Schreiber auf.

  • Eine Schreiber-Fähigkeit (z. B. long-video-story-questions): Rufe sie mit dem Thema, der Ziel-Dauer, der Sprache und der Konfigurations-Zusammenfassung auf. Ihr eigenes Ausgabeformat hat Vorrang. Forme es nicht in die Standardstruktur um.
  • open: Schreibe die unten stehende Standardstruktur.

Standardstruktur (offener Stil)

Stimme mit der Ziel-Länge in der Konfiguration überein. Gesprochene Erzählung läuft mit etwa 150 Wörtern pro Minute, ein 15-minütiges Video benötigt also etwa 2.250 gesprochene Wörter. Schreibe jetzt noch nicht das endgültige Skript. Schreibe die Geschichte: was passiert, in der Reihenfolge, mit genug Details, damit der Nutzer sie beurteilen kann.

  1. Titel (Arbeitstitel).
  2. Logline.
  3. Aufhänger. Die ersten 15 bis 30 Sekunden.
  4. Handlungsübersicht. Akte oder Kapitel. Für jedes: was passiert, der Wendepunkt, ungefährer Anteil an der Laufzeit.
  5. Vollständige Geschichte. Nacherzählung in Prosa, von Anfang bis Ende.
  6. Ende und Aufruf zum Handeln.
  7. Zu überprüfende Fakten. Liste alle sachlichen Behauptungen auf, die eine Quelle benötigen. Schreibe „keine“ für reine Fiktion.

Regeln für den offenen Stil:

  • Erfinde keine Fakten für eine nicht-fiktionale Geschichte. Markiere Unbekanntes in „Zu überprüfende Fakten“.
  • Kopiere keine bestehenden Werke. Verwende originelle Struktur und Formulierung.
  • Halte Sprache und Ton aus der Konfiguration ein.

Entwurf speichern

Speichere in story.md mit diesem Header und Status draft:

---
title: <Arbeitstitel>
status: draft
revision: 1
style: <Stil-ID>
writer: <Schreiber-ID oder "open">
config: <Konfigurationsname>
---

Setze den Text unter den Header. Zeige die Geschichte im Chat.

Schritt 5: Bestätigen oder überarbeiten

Wenn der Nutzer in Schritt 1 seine eigene Geschichte eingebracht hat, speichere sie zuerst als story.md mit dem obigen Header (style: user).

Frage: genehmigen oder Änderungen wünschen. Stelle die Frage in einer neuen Nachricht nach der Geschichte. Platziere die Frage nicht innerhalb der Ausgabe einer Schreiber-Fähigkeit.

  • Änderungen gewünscht. Wende sie an. Falls eine Schreiber-Fähigkeit den Text erstellt hat, behalte ihre Regeln (Format, Ton, Ehrlichkeit) beim Bearbeiten bei. Erhöhe revision. Zeige in zwei oder drei Zeilen, was sich geändert hat, dann zeige die aktualisierte Geschichte. Frage erneut.
  • Frage oder Zweifel. Beantworte sie. Biete eine Änderung an, wenn die Antwort ein Problem zeigt.
  • Möchte eine andere Geschichte. Gehe zurück zu Schritt 2. Behalte die alte Datei als story.rev<N>.md.
  • Genehmigen. Benötigt ein ausdrückliches Ja. Schweigen, „sieht bisher gut aus“ oder „ok, aber…“ ist keine Genehmigung. Wenn unklar, stelle eine direkte Frage: „Diese Geschichte festschreiben?"

Wiederhole, bis genehmigt. Dränge den Nutzer nicht.

Schritt 6: Festschreiben

  1. Setze status: approved im Frontmatter von story.md. Füge approved: <ISO-Datum> hinzu.
  2. Aktualisiere project.json: setze "stage": "story-approved".
  3. Teile dem Nutzer den Dateipfad mit. Sage, dass die Geschichten-Stufe abgeschlossen ist.
  4. Biete an, mit long-video-assets (Figuren, Umgebungen, Objekte und Stil) fortzufahren. Starte es nur, wenn der Nutzer zustimmt.

Regeln

  • Markiere eine Geschichte niemals als genehmigt ohne ein ausdrückliches Ja.
  • Ändere niemals stillschweigend eine genehmigte Geschichte. Das Wiederöffnen erfordert die Anfrage des Nutzers und setzt den Status zurück auf draft.
  • Überspringe niemals die Stil-Frage, wenn Claude die Geschichte schreibt.
  • Rufe niemals eine Stil-Fähigkeit auf, die nicht installiert ist.
  • Halte Vorschläge und Überarbeitungen kurz. Zeige den vollständigen Text nur für die Geschichte selbst an.

Individual skills in this repo

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

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-director

Turn an approved story into a shot-by-shot video script, acting as the director. Asks whether the video uses a narrator or characters who speak (or both), suggests professional filming choices (camera type, lenses, camera movement, lighting, color, pacing), saves them as a separate film style file, then writes a script that matches the project config. Outputs film-style.md and video-script.md. Use after long-video-story (and long-video-assets) are done, or when the user asks for the video script, shot list, camera style or lighting plan.

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

Verwandte Skills