Communitygithub.com

video-3d

Fabrik für vertikale 3D-Kurzvideos (YouTube Shorts, TikTok, Reels), vollständig per Code erstellt mit Blender, ffmpeg und KI-Sprache (kostenloses edge-tts oder MiniMax).

Was ist video-3d?

Die `video-3d`-Fähigkeit verwandelt Claude in einen vollautomatischen Videoproduzenten für vertikale 3D-Kurzfilme. Sie deckt den gesamten Workflow ab: von der Installation der Werkzeuge (Blender, ffmpeg, Python, Stimmen) über die Erstellung eines individuellen Kanals mit eigenem Charakter bis hin zur Produktion jedes Videos. Der Ablauf ist streng Schritt-für-Schritt: Benutzer und Claude definieren gemeinsam das Thema, die Formel (z. B. „Du baust“), schreiben das Drehbuch, generieren die Sprachausgabe, programmieren die 3D-Szene in Python, rendern sie, fügen Untertitel und Sound hinzu und veröffentlichen das fertige Video. Die Fähigkeit enthält ein Template-Projekt, Referenzhandbücher und ein Hilfsskript `make.py`, das die gesamte Pipeline orchestriert. Der Fokus liegt auf Effizienz durch Code, Qualitätssicherung durch Zwischenabnahmen (Stills, Kollisionsprüfung) und Wiederverwendbarkeit durch ein modulares Kit (`kit/base.py`, `kit/personagem.py`).

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zMalves/skill-3d-video/tree/HEAD/plugin/skills/video-3d

In Ihrer bevorzugten KI fragen

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

Dokumentation

Fabrik für 3D-Videos

Du (Claude) bist der Produzent des Kanals: Du schreibst Themen, Drehbücher, den Code für die 3D-Szene, generierst die Stimme, renderst und schneidest das Video. Der Benutzer entscheidet über Nische, Strategie, Charakter und Stimme und genehmigt jeden Schritt.

Ordner dieser Fähigkeit = der Ordner, in dem sich diese SKILL.md befindet (hier <skill> genannt). Er enthält:

  • template/ – vollständiges, fertiges Projekt zum Kopieren (Motor, make.py, doctor.py, Kanalmodell, 3D-Kit, Testvideo).
  • scripts/criar_projeto.py – kopiert die Vorlage in den Benutzerordner.
  • references/ – detaillierte Anleitungen. Lies die Anleitung des jeweiligen Schrittes, bevor du ihn ausführst (siehe Tabelle unten).
SchrittLies
Werkzeuge installieren/konfigurieren (Python, ffmpeg, Blender, Stimmen, MiniMax)references/01-setup.md
Kanal erstellen: Nische, Strategie, Identität, neuer Charakterreferences/02-canal-e-personagem.md
Formel „Du baust“ (Format des Referenzkanals)references/03-formula-voce-constroi.md
Drehbuch .md + .json schreiben (Karten, Highlights, Sounds, Rhythmus)references/04-roteiro.md
Stimmen: edge-tts (Standard) und MiniMax (optional)references/05-vozes.md
Blender und die 3D-Szene in Python (Kit, Kamera, Charakter, Kollision, Rendern)references/06-blender.md
Produktion, Überprüfung, Veröffentlichung und Metrikenreferences/07-producao-e-publicacao.md

0. Finde heraus, an welchem Punkt der Benutzer steht

  1. Suche ein Projekt: Ordner mit make.py + pipeline/ + canais/ (frage nach dem Pfad, falls nicht gefunden).
  2. Kein Projekt → Schritt A. Projekt ohne eigenen Kanal (nur canais/_modelo) → Schritt B. Kanal fertig → Schritt C.
  3. Unterhalte dich auf Portugiesisch (oder in der Sprache des Benutzers). Die Sprache des VIDEO-INHALTS wird in Schritt B festgelegt.

A. Installation (einmal pro Computer)

  1. Frage nach dem Projektordner (schlage ~/videos-3d vor). Führe aus: python <skill>/scripts/criar_projeto.py <pasta> (unter Windows ohne Python verwende das Python von Blender – siehe 01-setup).
  2. Folge references/01-setup.md: Installiere, was fehlt, und führe python doctor.py --instalar aus, bis „Alles bereit!“ erscheint.
  3. Beweise die Funktion mit dem Testvideo (Portugiesisch, ~26 s): python make.py video --canal _modelo --id 00-teste --stills 1,6,12,20 → zeige dem Benutzer die prancha.png; danach python make.py video --canal _modelo --id 00-teste (vollständiger Render; Minuten) → canais/_modelo/saida/00-teste.mp4.
  4. Stimme: Standard ist edge-tts (kostenlos, kein Konto). Frage, ob er MiniMax möchte (natürlicher, kostenpflichtig, benötigt Schlüssel). Wenn ja, leite die Erstellung des Schlüssels und der .env-Datei an (05-vozes). Schreibe den Schlüssel niemals in Code, Drehbuch oder Dokument.

B. Kanal erstellen (Onboarding – einmal pro Kanal)

Folge references/02-canal-e-personagem.md. Zusammenfassung dessen, was du FRAGEN musst (verwende AskUserQuestion bei Optionen):

  1. Format: dasselbe Format wie der Referenzkanal („Du baust“: der Zuschauer baut eine Maschine/Struktur Stück für Stück, jedes Teil löst ein Problem – 03-formula-voce-constroi.md) oder eine eigene Nische/eigenes Format? Bei eigenem Format: Frage den Benutzer nach Nische, Ideen, Referenzen und Strategie; verwandle dies in eine Schritt-für-Schritt-Formel mit Zeitangaben, wie beim Referenzkanal (Aufhänger in der 1. Sekunde, Spannungsbogen, Abschluss, CTA).
  2. Sprache des Inhalts, Zielgruppe und Plattformen. 3. Name/@ und Identität (Farben, Ton). 4. Stimme (Motor + Stimme; generiere Samples mit python make.py vozes --canal <c>).
  3. NEUER Charakter – obligatorisch. Verwende niemals den Charakter eines anderen Kanals wieder. Erstelle das personagem.json mit dem Benutzer, rendere es (python make.py personagem --canal <c> --pose ideia), zeige die Bilder und iteriere, bis er es genehmigt.

Erstelle den Kanal mit python make.py novo-canal --canal <nome> und fülle estrutura.md, identidade.md, canal.json, personagem.json aus. Trage die Entscheidungen im Abschnitt „Entscheidungen“ der estrutura.md ein.

C. Ein Video produzieren (für jedes Video wiederholen)

Halte die Reihenfolge ein – jeder Schritt hat einen Genehmigungspunkt durch den Benutzer:

  1. Thema aus der Ideensammlung der estrutura.md (oder neuer Vorschlag) → Benutzer wählt.
  2. Karte (im Format „Du baust“: Karte der Problem → Teil → Name-Zyklen, 4–6 Zyklen mit Steigerung) → Genehmigung.
  3. Recherche: Überprüfe jede Tatsache und Zahl in vertrauenswürdigen Quellen; notiere die Quellen in der .md-Datei.
  4. Drehbuch .md detailliert (kopiere roteiros/_modelo.md) + Checkliste → Genehmigung.
  5. Drehbuch .json (kopiere roteiros/_modelo.json) – Dialoge, Karten, highlight, punch, sounds.
  6. Stimme: python make.py video --canal <c> --id <id> --sovoz → informiere über die Gesamtdauer (timing.json) und bitte, sich build/<id>/audio/ anzuhören. Passe den Text an und generiere neu (Cache erstellt nur geänderte Teile neu). MiniMax berechnet pro Sprachausgabe: vorher überprüfen.
  7. 3D-Szene: cenas/cena_<tema>.py mit kit/base.py + kit/personagem.py (06-blender). Jede Aktion ist an das Wort mit W(cena, "palavra") gebunden. Beginne, indem du die Struktur von canais/_modelo/cenas/cena_teste.py kopierst.
  8. Standbilder: --stills 1,4,8,… (eines alle 2–4 s) → lies die prancha.png SELBST (Read des Bildes), korrigiere Bildausschnitt, Charakter außerhalb des Rahmens, sich überschneidende Teile; zeige es dann dem Benutzer.
  9. Kollision: --colisao → null Warnungen (oder nur erwartete Kontakte, behandelt in ignorar).
  10. Vollständiger Render (führe im Hintergrund aus; 720p ≈ 1–2 s pro Bild) → automatischer Schnitt → saida/<id>.mp4.
  11. Endkontrolle: extrahiere Einzelbilder aus dem MP4 mit ffmpeg und überprüfe Untertitel/Karten; Benutzer schaut mit Ton an.
  12. Veröffentlichung: Titel, Beschreibung, TikTok-Untertitel, Hashtags, fixierter Kommentar (07-producao). Trage in die Metrik-Tabelle ein.

Immer gültige Regeln

  • Vertikales Video 1080×1920, 30 fps. Aufhänger in der 1. Sekunde; das erste Bild zeigt bereits die Situation (funktioniert ohne Ton).
  • Formate kopieren, niemals Werke: kein Name, Maskottchen, Charakter, Dialoge oder Kunst anderer Kanäle.
  • Fakten und Zahlen vor der Sprachgenerierung überprüft. Keine gefährlichen Anweisungen, die der Zuschauer wiederholen soll.
  • Alles, was zum Standard wird (Teil, Pose, Effekt, Szene), kommt aus der cena_*.py und wird in cenas/kit/ verschoben.
  • Nummerierung pro Kanal: 01-tema, 02-tema… – gleiche ID in Drehbuch, Build und Ausgabe.
  • Lange Render: im Hintergrund ausführen und nicht ständig nachprüfen; make.py zeigt den Fortschritt.
  • Bevor du sagst, dass ein Video fertig ist, schau es dir selbst an.

Verwandte Skills