bp-abe/skills-video

Animiertes Video (Remotion)

Infrastruktur, kein Geschmack. Die Skill speichert, was das Modell nicht allein mitbringt – Werkzeuge (Sprache, Soundtrack, Rendering, Transkription), Unternehmenskontext (autorisierte Stimmen, Schlüssel, Firewall, Lizenzen), Faktenregeln, technische Details, Überprüfung und technische Lehren – und schreibt nicht vor, wie das Video aussehen soll. Stil, Gerät und Look entstehen aus dem Inhalt bei jedem Video neu. Bei der Weiterentwicklung der Skill niemals ein Beispiel für einen Look, ein ästhetisches Rezept oder eine "Standard"-Komponente zu dem Hinzufügen, was immer gelesen wird: Das führt zu Wiederholungen.

Was gelesen werden soll

Immer

Auf Anforderung

diese Datei · APRENDIZADOS.md (Technik) · direcao.md (Handwerk)

gemini.md (Stimmen, APIs, Fähigkeiten) · assets.md (Lizenzen, Asset-Quellen) · edicao.md (Aufnahme) · critica.md (Überprüfung) · referencias.md (nur wenn die Anfrage eines der untersuchten Videos nennt) · biblioteca/ (erst nach der Konzeptwahl) · VIDEOS.md und alte Projekte (nur wenn ein Stil explizit verlangt wird – nicht um zu sehen, welche Stimme andere verwendet haben) · historico/ (wenn ein Problem bekannt erscheint)

Die Anfrage lesen

Die Skill ist die Regisseurin: Sie versteht, was die Anfrage will, und handelt. Sie stellt keinen Fragebogen; sie fragt nur, was wirklich klärungsbedürftig ist (politische/historische Mehrdeutigkeit, Fakten, die die Quellen nicht lösen, unklare Nutzungsrechte), und gibt dabei eine Empfehlung.

Die Anfrage bringt…	Vorgehen
Nur ein Thema	Alles selbst erstellen (Recherche, Drehbuch, Konzept, Stimme, Soundtrack) und fertig ausliefern.
Ein Drehbuch	Der Text bleibt wie er ist (Anpassungsvorschläge separat, optional); das Briefing zeigen und nach OK produzieren ("mach direkt" überspringt das).
Notizen, Bericht, Stichpunkte	Das Drehbuch daraus schreiben (Ton, Schnitte, Anonymisierung) und Drehbuch + Briefing vor der Produktion zeigen.
Beratung ohne Inhalt ("Welche Animation empfiehlst du für…")	Kein Konzept auswählen: Das Konzept entsteht aus dem Text. Sagen, wovon die Wahl abhängt, und den Inhalt anfordern.
Angebotsanfrage	Nur das Briefing (PROPOSTA.md).
Spezifische Anweisungen	Genau befolgen; Freiheit nur bei dem, was nicht gesagt wurde.
Eine Aufnahme zum Schneiden	Bearbeitungsmodus: edicao.md.
Anpassung eines bestehenden Videos	Nur das ändern und neu rendern.
Stilvorlage ("wie Video X", "Serie")	Den Eintrag in VIDEOS.md laden, tema.ts und Teile des Projekts kopieren, das Aussehen beibehalten; roteiro.linha_de_estilo.
Leeres Blatt ("von null", "nichts fertig")	Nur die technische Basis; kein Stück aus der Bibliothek oder untersuchte Referenz.
Externe Referenz (Link, Video)	Bild für Bild studieren, die Grammatik (Rhythmus, Technik) übernehmen, niemals den Inhalt oder das Aussehen.
"Ohne die APIs zu verwenden"	"offline": true, lokale Stimme, Soundtrack partitura oder arquivo, keine Bildgenerierung.

Anfragen können kombiniert werden. Defaults: ~45–60 s als Referenz · 16:9 + 9:16 · Stimme VoxCPM2, geklont von einer autorisierten Referenz ("voz": "voxcpm", bereits in der Vorlage) nur für den internen Gebrauch – Videos, die an die Öffentlichkeit gehen (Kampagnen, soziale Netzwerke, Kunden) benötigen eine andere Stimme: Zusammen mit dem Briefing fragen, mit Empfehlung. Anfrage nach einer anderen Stimme: Name → verwenden; Beschreibung → gemini.md; "Optionen" → Beispiele · CTA mit URL nur, wenn das Ziel der Verkauf ist. Die Dauer bestimmt der Inhalt; schätzen anhand der gemessenen Sprechrate der gewählten Stimme (niemals vor dem Messen versprechen). Langes Video: Akte mit eigener Funktion und vollständigen Durchläufen, aufgeteilt auf Unteragenten.

Regie-Briefing (vor jeglichem Code)

In der Reihenfolge – Logline und Grenzen zuerst, Ästhetik danach, Werkzeuge zuletzt (mit der Technik zu beginnen, lässt die Technik die Idee überlagern). Kommt in die PROPOSTA.md (bei erhaltenem Drehbuch/Angebot) oder an den Anfang der ANALISE.md. Ziel, immer: Portfolio-Stück eines Motion-Design-Studios – höchstmögliche Verarbeitung, nicht das Minimum, das funktioniert. Gilt für jeden Stil (minimalistisch oder dicht); was sich ändert, ist, wo die Verarbeitung sichtbar wird.

1. Logline: Das Video in einem Satz + Zielgruppe + Wo es läuft + Was die Person am Ende fühlen/tun soll.
2. Grenzen: Dauer, Formate, Wahrheit (Quellen; was ist Illustration), Rechte, API-Budget.
3. Unvoreingenommene Ideenfindung: 3 deutlich unterschiedliche Konzepte, nur aus dem Inhalt (ohne Bibliothek oder frühere Videos zu öffnen), jedes vollständig: Gerät, visuelle Welt, Materialien, Palette, Typografie, Bewegung, Klangpalette und Soundtrack. In conceitos.json deklarieren und python3 scripts/diversidade.py --conceitos ausführen – das Modell hat Weltreflexe, die sich wiederholen, selbst ohne Verlauf zu sehen; das Skript (das nur es liest) zeigt darauf hin. Weniger als 2 freie → neu erfinden. Ein schnelles Bild von jedem in out/conceitos/ und durch Ansehen auswählen; wenn es ein Briefing zur Genehmigung gibt, werden die 3 Bilder mitgeschickt. Alle 3 und das Warum protokollieren; die Materialien des ausgewählten Konzepts gehen in roteiro.conceito.materiais.
4. Visuelle Bibel mit dem Warum jeder Wahl und einem Satz für die Qualitätsrichtlinie → src/tema.ts. Wiederkehrende Figur → Figurenbibel (Proportionen, Palette, Ausdrücke, was sich nie ändert).
5. Decoupage: Block für Block, die Funktion jedes Blocks, was erscheint, Übergang, Ton.
6. Werkzeuge: Stimme; Soundtrack; Assets – Web mit Lizenz (assets.md, CREDITOS.md), Generierung (scripts/img.py, Veo: siehe gemini.md) oder Zeichnen in Code.
7. Asset-Durchlauf (nach der Bibel, vor der Animation): Ein für DIESES Video erstelltes Set, ein Asset pro Idee des Drehbuchs (Figuren, Objekte, Umgebungen, Texturen), alle mit der gleichen Behandlung. Generiert: tratamento_imagem + imagens in roteiro.json, das 1. genehmigte Bild wird zur ref für den Stil der anderen, recorte für freistehendes Element (python3 scripts/img.py). Kein Budget oder offline: Mit der gleichen Sorgfalt in Code zeichnen. Generierte Bilder repräsentieren niemals echte Personen oder Fakten ohne den Hinweis "Illustration". Das hat Studioarbeit von korrekter Arbeit am meisten unterschieden.

Gates (nicht überspringen)

brief → drehbuch → stimme → messen → ton + beats → assets → storyboard → animatic → vollständiger durchlauf → kritik → render → auslieferung → weiterentwickeln

1. Projekt: bash ~/.claude/skills/video-animado/novo.sh ~/videos/<slug>. Die ANALISE.md des Projekts enthält bereits die Checkliste der Gates: jedes beim Passieren abhaken; nur überspringen, was die Anfrage ausgeschlossen hat, mit Begründung.
2. Drehbuch in roteiro.json (einzige Quelle) + ROTEIRO.md mit Quellen. Faktencheck vor der Sprachaufnahme, immer.
3. Stimme: python3 scripts/tts.py (nur geänderte Blöcke neu aufnehmen). Prüfen: ~/.venvs/tts-local/bin/python scripts/check_voz.py.
4. Messen: python3 scripts/tighten.py; natürliche Sprache oder WICHTIG → ~/.venvs/tts-local/bin/python scripts/align.py (cueW).
5. Ton + Beats: Soundtrack (lyria → scripts/music.py; arquivo; partitura in Code komponiert, mit intensidade pro Block und eventos der Szene) und python3 scripts/sound.py (Timeline, Effekte, Spitzen, beats.json der Partitur). Soundtrack fertig → ~/.venvs/tts-local/bin/python scripts/beatmap.py. Effekte nach Familie (biblioteca/sfx/INDEX.md), ausgewählt nach Material, via sfxVar (die Spitze trifft die Aktion automatisch).
6. Storyboard: Ein Standbild pro Moment des Drehbuchs, geprüft gegen die Bibel und gegen "Was kann weg?".
7. Animatic: Schnell-Render (npx remotion render Video-9x16 out/animatic.mp4 --scale=0.4), um Rhythmus und Beats vor der Endbearbeitung zu justieren.
8. Vollständiger Durchlauf in src/Video.tsx (das Beispiel der Vorlage ist nur Synchronisation: ersetzen; die Komponenten bauen, die das Konzept verlangt). Langes Video: Szenengruppen zwischen Unteragenten aufteilen, mit tema.ts und zentralen Regeln.
9. Kritik: python3 scripts/qa_folhas.py out/<mp4> + sauberer Unteragent mit Bewertung (critica.md), bis alles ≥ 8 (maximal 3 Runden; der Kritiker bewertet gegen die Bibel des Videos, nicht gegen seinen eigenen Geschmack). python3 scripts/diversidade.py ok (gewünschte Kontinuität: roteiro.linha_de_estilo).
10. Render: bash scripts/render.sh (−14 LUFS in zwei Durchgängen, die Formate des Drehbuchs); im relatorio.txt der qa_folhas.py prüfen (−14 ± 1).
11. Auslieferung: MP4s + Titelbild (npx remotion still … out/capa.png) + Prüfblätter + ANALISE.md (Briefing, Entscheidungen, Quellen, Kritikanmerkungen, was menschliches Hören erfordert) + Datei im Finder anzeigen (open -R). Die finale Nachricht fordert die Bewertung (1–5) an und was geändert werden würde.
12. Weiterentwicklung der Skill: Bewertung des Anforderers → diversidade.py --registrar → technische Lektion in APRENDIZADOS.md (kurz; beim Hinzufügen zusammenführen oder entfernen), ästhetische Entscheidungen in VIDEOS.md, wiederverwendbares, themenneutrales Stück in biblioteca/ (+ INDEX.md), korrigierter und in beiden Formaten getesteter Bug der Vorlage, neue Fähigkeit in gemini.md. Handwerkliche Lektion, die in 2 Videos wiederholt wird → direcao.md (ohne Look-Beispiel).

Code-Vertrag

• Zeit ist niemals eine lose Zahl: cue, cueW, blockStart, naBatida(frame), batida(i), virada().
• Format: useFmt() + pick(paisagem, retrato); jede Szene läuft in beiden (neu einrahmen, nicht zuschneiden).
• Bewegung: mola(frame, at, 'ui'|'padrao'|'pesada'|'viva'); Regeln in direcao.md.
• Neutraler Kern der Vorlage: tema.ts (Farben und Schriftarten des Videos), lib.ts (Zeit, Format, Beats, Federn), stage.tsx (SceneStack mit corte/wipe/zoom oder eigenem Übergang TransFn, Sheet, Soundtrack, sfxVar), acabamento.tsx. Fertige Teile liegen in biblioteca/componentes/, optional, nur nach der Konzeptwahl geöffnet.
• Jede Animation geht vom Frame aus (useCurrentFrame + interpolate/mola); interpolate immer mit extrapolateLeft/Right: 'clamp'; niemals transition/animation von CSS (erscheinen nicht im Render).
• Pakete @remotion/* 4.0.528 in der Vorlage (transitions, paths, shapes, noise, motion-blur, lottie, three, media-utils, layout-utils); neue in derselben Version.

Harte Regeln

• Schlüssel in ~/.config/secrets.env (source davor; niemals ausgeben). Ohne Budget/Ausgabenobergrenze: lokale Stimme und partitura.
• Stimmklon nur mit schriftlicher Genehmigung; geklonte Stimme einer echten Person ist interne Nutzung, außer bei ausdrücklicher Genehmigung für die öffentliche Nutzung.
• Fremd-Assets nur mit klarer Lizenz, eingetragen in CREDITOS.md; niemals Fotos echter Personen ohne Rechtsgrundlage, kommerzielle Musik oder Logos Dritter, die offizielle Werke imitieren.
• Wahrheit: Daten mit Quelle oder Hinweis "Illustration/Beispiel"; nichts auf dem Bildschirm oder in der Bildunterschrift des Beitrags erfunden.
• MP4 und Audio nicht in öffentliche Repos. Nicht ohne Nachfrage committen.
• Parallele Sitzungen, die die Skill verändern (git status mit Änderungen, die nicht Ihre sind): nur punktuelle Änderungen, oder eigener Worktree (claude --worktree) und Merge – niemals die Datei einer anderen Sitzung überschreiben.