Communitygithub.com

CrissAlvarezH/reel-studio

Wie ein erklärendes Video in einem Reel Studio Workspace erstellt wird – in jedem visuellen Stil: Drehbuch, Bilder, Stimme, Aufbau, Board, Sound, Stummtest, Rendering – basierend auf den Einstellungen des Studios (Profil, Format, Stimme, Bildquellen). Verwende es für jedes neue oder überarbeitete Video in den Videos eines Projekts (`projects/<id>/videos/`). Die Video-Art fügt ihre eigene Fähigkeit (`styles/<id>/SKILL.md`) für das Aussehen und das Remotion-Kit hinzu; `LESSONS.md` enthält Erkenntnisse aus früheren Videos.

Was ist reel-studio?

Dieser Skill beschreibt den vollständigen Workflow zur Erstellung eines erklärenden Videos mit Reel Studio – von der Erstellung eines neuen Video-Ordners über das Drehbuch, die Bildsuche, die Sprachsynthese, den Aufbau der Szene, die Erstellung eines Storyboards, die Soundmischung, den Stummtest bis hin zum finalen Render. Er ist für jede Art von Video (animiert, Voice-Over, Talking-Head) und jeden visuellen Stil anwendbar. Die Einstellungen aus dem Studio (Profil, Format, Stimme, Bildquellen) überschreiben die Standardregeln. Der Skill kooperiert eng mit anderen Fertigkeiten wie `video-script` und `content-ideas` und erwartet, dass der Nutzer jeweils mit einer Empfehlung antwortet, sodass ein „Ja“ die vollständige Anweisung ist. Er enthält detaillierte Anweisungen für jedes Werkzeug, den Umgang mit dem Workspace, die Struktur der Dateien und Ordner sowie die Integration von APIs wie TTS, Bildsuche und Audio-Mixing. Der gesamte Prozess ist darauf optimiert, schnell von einer Idee zu einem veröffentlichten Video zu gelangen, wobei nur das Nötigste geändert wird und alle Schritte protokolliert werden.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Reel Studio – Wie ein Video erstellt wird

Der Ablauf ist für jeden Stil gleich. Wie ein Video aussieht und klingt, wird durch seinen Stil bestimmt; für wen es ist, welches Format, die Stimme und woher Bilder kommen können, wird durch die Einstellungen des Studios festgelegt. Der allgemeine animated-video Skill beschreibt die breitere Methode (Brainstorming, Board, Stummtest, Review); wo er abweicht, gewinnen dieser Skill und der Stil. Frage mit einer Empfehlung, sodass „Ja“ eine vollständige Antwort ist. Ideen zu entwickeln und sie auf dem Board des Projekts zu speichern, liegt im Verantwortungsbereich des content-ideas Skills, bevor dieser Prozess beginnt.

Der Workspace

  • projects/<id>/ – ein Projekt: ein Kanal, für den der Ersteller Videos macht (die Projektauswahl des Studios; die Eingabeaufforderung gibt an, welcher geöffnet ist). Sein config/ enthält seine Einstellungen (Ajustes): profile.json, voice.json und account.json (sein Instagram, Mi cuenta); account/ speichert das, was von diesem Konto heruntergeladen wurde. Greife nicht in den Ordner eines anderen Projekts ein, es sei denn, du wirst darum gebeten.
  • projects/<id>/videos/<slug>/ – ein Video: ein Remotion-Projekt, das aus der Vorlage seines Stils kopiert wurde. title.txt (sein Name im Studio), style.txt (eine Stil-ID), audio/vo.txt (der Erzähltext, genau wie er an die Stimme geht), audio/beats.json (die Struktur des Drehbuchs), src/format.json (Größe, fps, Lautstärke), CREDITS.md, caption.md, out/ (Renderversionen, Boards; nicht versioniert).
  • formats/<id>/format.json – ein Format: die Art des Videos (vollständige Animation über einer generierten Stimme oder über der aufgenommenen Stimme des Erstellers; der Ersteller spricht vor der Kamera mit Animationen …), was auf dem Bildschirm zu sehen ist und wie es geschnitten wird. Ein Video benennt sein Format in format.txt (keines: der Standard, animated). skill verweist auf seine eigenen Anweisungen, overlay auf Dateien, die es über die Vorlage des Stils legt; "footage": true bedeutet, dass das Video mit seiner Aufnahme in footage/ beginnt ("voiceOnly": true: nur sein Ton – Audios – wird verwendet).
  • styles/<id>/style.json – ein Stil: Palette und Bedeutung jeder Farbe, Schriftarten, Aussehen, Bewegung, Bilder, was zu vermeiden ist. skill verweist auf seine eigenen Anweisungen, template auf das Remotion-Projekt, das neue Videos kopieren.
  • config/ (im Stammverzeichnis) – Einstellungen, die jedes Projekt gemeinsam nutzt: images.json (Bildquellen), social.json (Scraper).
  • tools/ – gemeinsame Skripte. LESSONS.md – Erkenntnisse aus früheren Videos.
  • projects/<id>/inspiration/<account>/ – Reels anderer Konten, die auf der Inspiración-Seite des Projekts untersucht wurden: account.json (analysis.text: was für diesen Account funktioniert) und pro Reel reel.json (Metriken, Bildunterschrift), transcript.json, analysis.json (Hook, Struktur, Visuals, CTA, was mitzunehmen ist), hook.jpg (erste 3 s) und sheet_NN.jpg (1 Frame/s). Verwende sie für Blickwinkel und Hooks, wenn du danach gefragt wirst; passe sie an das Profil des Erstellers an, kopiere niemals ein Drehbuch.

Einstellungen kommen aus dem Studio

Reel Studio fügt das Profil (Sprache, Plattform, Zielgruppe, Länge, Caption-Regeln), das Format des Videos, die Stimme und die Bildquellen bei jeder Runde in deine Eingabeaufforderung ein. Sie haben Vorrang vor diesem Skill und dem Stil. Gib niemals eine Stimmen-ID oder Einstellungen, eine Größe, eine Bildrate oder einen Lautstärke-Zielwert fest vor.

API-Schlüssel befinden sich im .env-Verzeichnis des Workspace (festgelegt unter Ajustes, neben der Angabe, wofür sie bestimmt sind: Voz, Extracción de datos). Die Werkzeuge lesen sie; gib niemals einen Schlüssel aus oder frage in einem Chat danach – wenn einer fehlt, bitte den Ersteller, ihn unter Ajustes hinzuzufügen.

Python: Werkzeuge, die nur die Standardbibliothek verwenden, werden mit python3 ausgeführt (python unter Windows): tts.py, el_words.py, standin_words.py, commons.py, openverse.py, pexels.py, pixabay.py, unsplash.py, generate_image.py. Werkzeuge, die Pakete benötigen, werden mit der virtuellen Umgebung des Workspace ausgeführt:../../../../.venv/bin/python (Windows: ../../../../.venv/Scripts/python.exe): cutout.py, audio/mix.py und sheet.py (snap.sh verwendet es, oder ffmpeg, wenn keine venv vorhanden ist). Stile, die Cutouts benötigen, brauchen die venv (Ajustes → Requisitos installiert sie). Pfade unten sind relativ zum Video-Ordner.

Bevor du beginnst

Lies das Format des Videos: formats/<id from format.txt>/format.json und, falls vorhanden, seinen Skill – er beschreibt, wie diese Art von Video erstellt wird und hat Vorrang vor den folgenden Schritten, wo sie abweichen (z. B. bei seiner Aufnahme gibt es kein Drehbuch zu schreiben oder keine Stimme zu generieren: der Schnitt liefert beides). Lies den Stil des Videos: styles/<id from style.txt>/style.json und, falls vorhanden, seinen Skill. Das Format bestimmt niemals Farben, Schriftart oder Rahmen: das ist Sache des Stils. Lies LESSONS.md (den allgemeinen Teil und den des Stils). Ein Stil ohne Skill oder Vorlage wird auf der Vorlage des Standardstils (template/) aufgebaut, wobei das Aussehen auf sein style.json geändert wird; sage das zu Beginn.

Schritte

  1. Neues Video – das Studio erstellt es aus der ersten Nachricht (Ordner, Titel, Stil, Format, Größe). Über ein Terminal oder die allgemeine Konversation: scripts/new-video.sh <slug> [style] [format].
  2. Drehbuch – mit dem video-script Skill (Hook, Halten der Antwort, Timing, Checkliste), beginnend mit den Notizen der Idee, wenn sie vom Board kommt. Plattform, Sprache, Zielgruppe und Länge aus dem Profil; Wörter ≈ das gemessene Tempo der Stimme × die Zielsekunden. Ziel: Reichweite, sofern nicht anders angegeben. Zahlen in audio/vo.txt ausschreiben („mil cuarenta y dos“) und in src/captions.ts DISPLAY wieder in Ziffern umwandeln. Genehmigung einholen. audio/vo.txt und audio/beats.json schreiben.
  3. Bilder – Mit einem neuen Agenten ein Bild pro Beat brainstormen (animated-video → find the pictures). Bevorzuge ein wiederkehrendes physisches Motiv, das das System über den gesamten Film spielt (ein Karteikartenschrank = der Server, Schubladen = Datensätze). Die Bilder halten die Frage des Drehbuchs offen: Der erste Frame wirft sie auf, und kein Bild oder Titel auf dem Bildschirm zeigt die Antwort, bevor der Erzähler dort ankommt. Das Konzept genehmigen lassen.
  4. Stimme – python3 ../../../../tools/tts.py audio/vo.txt audio/vo.mp3, dann ffmpeg -y -i audio/vo.mp3 -ar 48000 public/vo.wav und python3 ../../../../tools/el_words.py audio/vo.alignment.json public/vo.wav (ergibt src/words.json, src/vo_env.json). Bevor die Stimme existiert: python3 ../../../../tools/standin_words.py audio/vo.txt src/words.json (zeitlich abgestimmt auf das Tempo der Stimme; nenne es einen Platzhalter). Erstelle zuerst eine kurze Probe, wenn sich etwas an der Stimme ändert. Verwende das Audio so, wie es zurückkommt (kürze keine Pausen, es sei denn, du wirst darum gebeten). Jede Erzeugung kostet Zeichen: generiere nicht ohne Grund neu.
  5. Bilder – Suche frei im Web mit verfügbaren Such- und Browser-Werkzeugen; jede Website kann eine Quelle sein. Die Eingabeaufforderung listet optionale API-Integrationen auf, keine erlaubte Liste oder verbindliche Reihenfolge. Verwende diese APIs nur, wenn sie aktiviert und konfiguriert sind; die freie Websuche benötigt keine Quelleinstellungen. Downloads gehen nach assets/src/ (nicht versioniert); notiere jedes Bild in CREDITS.md (Titel, Autor, Lizenz, wenn bekannt, Original-Link; erfinde niemals eine Lizenz). Wenn Stockmaterial nicht ausreicht, bitte um ein Handyfoto der genauen Geste (einfacher Hintergrund, gutes Licht). Wie Bilder behandelt werden, ist Sache des Stils.
  6. Aufbau – Arbeitet in src/lib.ts ACTS (Schnitt ~0,08 s vor dem ersten Wort jeder Handlung), Untertitel als Sinneinheiten in src/captions.ts (Wort für Wort gegen das Transkript geprüft), eine Szene pro Handlung in src/film/scenes.tsx. Jedes Timing stammt von einem Cue (cue('phrase'), at('phrase')), sodass eine neue Stimme den Film neu timet. Größen und Frames aus src/lib.ts (W, H, FPS, f()), niemals Literalzahlen. Die Komponenten sind die des Stils.
  7. Board – ./snap.sh out/board <sec> … rendert Standbilder und sheet.png. Zeige einen Schlüsselframe pro Beat; hol dir die Zustimmung. Gib die Zeiten wörtlich an (in zsh teilt eine durch Leerzeichen getrennte Liste in einer Variable nicht auf).
  8. Sound – Das Cue-Blatt in audio/mix.py, mit Zeiten von denselben Cues, die die Szenen verwenden; ../../../../.venv/bin/python audio/mix.py → public/mix.wav; setze audio: true in src/Root.tsx. Welche Sounds: die des Stils. Sage bei der Auslieferung, welche Sounds synthetisch sind.
  9. Stummtest – vor dem ersten vollständigen Schnitt: ffmpeg -i out/<name>.mp4 -vf "fps=2,scale=270:-1,tile=8x5" out/mute/sheet_%02d.png und gib diese Blätter nur an einen neuen Agenten weiter (ignoriere Untertitel; erzähle neu; liste Verwirrungen und Brüche auf). Korrigieren, Standbilder erneut prüfen.
  10. Render – Unter macOS und Linux zuerst verwaiste Renderer beseitigen: ps -A -o pid=,ppid=,command= | awk '$2==1 && /chrome-headless-shell/ {print $1}' | xargs kill. Dann CONCURRENCY=3 ./render.sh <name> → out/<name>.mp4, normalisiert auf die Lautstärke des Formats. Überprüfe Dauer, Lautstärke, ersten und letzten Frame. Schreibe caption.md mit den Caption-Regeln des Profils und den Credits; seine Eröffnung wirft die Frage des Hooks auf, anstatt sie zu beantworten. Wenn das Video oder die Caption die Leute auffordert, ein Wort zu kommentieren, um etwas zu erhalten, schreibe automatizacion.json (Reel Studio → Instrucciones automatización) mit dem, was in ManyChat oder InstantDM eingefügt wird, als Zeichenfolgen: keyword (das genaue Wort), reply (die öffentliche Antwort auf den Kommentar), dm (die direkte Nachricht) und link. Jedes wird so kopiert, wie es ist, also keine Notizen darin; lasse leere Felder aus und erfinde niemals einen Link. Melde den Pfad, offene Probleme, übersprungene Prüfungen, was synthetisch oder erfunden ist, und die Credits.

Nach einem Video

Kundenprojekte, Videos, Präferenzen, benutzerdefinierte Stile und persönliche Lektionen bleiben lokal und werden vom Repository der Anwendung ignoriert. Committe oder pushe sie nicht dorthin, auch nicht nach einem Render; füge niemals ignorierte Daten mit force hinzu. Ein separates Repository für Kundeninhalte erfordert die ausdrückliche Aufforderung des Erstellers.

Füge hinzu, was eine Überarbeitung gekostet hat, zu LESSONS.md, eine Zeile pro Grund mit dem Grund, unter dem allgemeinen Teil oder dem des Stils.

Wenn die Zahlen des veröffentlichten Videos zurückkommen, lies sie mit video-script → Review. Es ist wichtig, schnell von der Idee zum veröffentlichten Video zu gelangen, weil viele Videos floppen werden und jedes etwas lehrt, also ändert eine neue Version so wenig wie möglich: Behalte, was genehmigt wurde, ändere nur, was getestet wird (ein neuer Hook, ein Schnitt, wo die Leute gegangen sind), und generiere die Stimme nur für den Erzähltext neu, der sich geändert hat. Füge keine Verbesserungen hinzu, um die niemand gebeten hat.

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

Write short-form video scripts that hold viewers, using the creator's own video analytics. Use when choosing the hook of a chosen idea, writing or tightening a script before filming (talking-head or narrated explainer), or turning a posted video's insights into lessons. Coming up with ideas is content-ideas'.

Verwandte Skills