Communitygithub.com

Gerador de Vídeos

Erstellt klare, kostengünstige Videos auf Portugiesisch aus einem Skript – animiert für Reels/TikTok/Shorts und als Tutorial-Bildschirmaufnahme.

Was ist Gerador de Vídeos?

Der Skill **Gerador de Vídeos** erstellt aus einem Drehbuch hochwertige, portugiesischsprachige Videos in zwei Modi: **animiert** (1080×1920, Reels/TikTok/Shorts) mit Figur, wortgenauen Untertiteln, ständiger Kamerabewegung, Musik und Qualitätskontrolle, sowie **Tutorial** (2560×1440, reale Webseite mit Mauszeiger, Zoom und Highlights). Die Arbeit beginnt mit dem Einlesen der Dokumentation (`docs/04_VIDEO_ANIMADO.md` für animiert, `docs/01` und `docs/02` für Tutorial) und folgt einem zehnstufigen Workflow: Skriptfreigabe (ggf. mit Skill `roteirista`), Kopieren der Vorlage, Anpassen von `roteiro.py` (Sprechtexte, Marke, Figur), Erstellen von `pagina.html` mit Szenenfunktionen, Vorschau über Einzelfotos (`--fotos`), Endrendering (MP4 + reine Sprachversion + QA-JSON), Cover-Generierung, Textprüfung und Auslieferung. Der Skill unterstützt automatisierte Qualitätskontrollen (Auflösung, FPS, Standbilder, schwarze Bildschirme, Lautstärke) und optionale redaktionelle Vorab-QA. Sicherheitsregeln verbieten personenbezogene Daten in externen Sprach‑APIs, Schlüssel nur in `~/.secrets/`, transparente Hinweise bei Simulationen und kostenpflichtige API-Aufrufe nur mit Benutzerfreigabe.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/scamposgabriel/gerador-de-videos/tree/HEAD/.claude/skills/gerador-de-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Gerador de Vídeos?

Antworten auf Portugiesisch. Bildschirmtexte und Erzählung ohne Fachjargon. Vor einem neuen Video lese docs/04_VIDEO_ANIMADO.md (animiert) oder docs/01 und docs/02 (Tutorial) sowie docs/03_QUALIDADE_E_CHECKLIST.md.

Ablauf eines animierten Videos (am häufigsten nachgefragt)

  1. Skript genehmigt. Falls nicht vorhanden, verwende den Skill roteirista und zeige dem Benutzer vor der Aufnahme Skript + Storyboard.
  2. Vorlage kopieren: videos/exemplo-bolinha-vermelha → videos/<kurzer-video-name> (neuer Ordner; niemals das Beispiel ändern).
  3. roteiro.py: Ersetze FALAS (eine Rede = eine Szene, cena="name"), MARCA (Kanalname, Avatar) und ggf. PERSONAGEM (Ordner mit PNGs der Posen). Passe saida und saida_so_voz an.
  4. pagina.html: Für jede Szene eine Funktion cName(r, c), registriert in MONTA. Wiederverwende die Teile der Vorlage: quando(cena, "wort") (Zeitpunkt, an dem die Stimme das Wort spricht), entra() (synchronisierter Eintritt), sai(), anim(), personagem() (Positionswechsel zum richtigen Wort; Gegenstände in der Hand über .extra), bola()/bolaDiv(), jardim(), cachorro(), som(), Endkarte (montarFim) und Cover (montarCapa, gezeichnet in render(t < 0)). Farben in --fundo, --tinta, --destaque.
  5. Vor dem vollständigen Rendern prüfen: py motor/animar.py videos/<ordner> --fotos 0,3,8,15 (PNG in echter Auflösung in saida/fotos) und erstelle ein Blatt, um Szene für Szene zu betrachten. Test mit Ton: --ate 12.
  6. Aufnehmen: py motor/animar.py videos/<ordner>. Es entsteht das MP4 mit Musik, die Version "nur Stimme" und saida/controle_de_qualidade.json (automatische QA: Auflösung, FPS, Standbild > 1 s, doppelte Frames, schwarzer Bildschirm, Lautstärke -14 LUFS, Spitze).
  7. Cover: py ferramentas/capa.py videos/<ordner> → saida/Capa.png.
  8. Texte: py ferramentas/verificar_textos.py videos/<ordner> (abgeschnittener Text, außerhalb des Bildschirms oder unter den Instagram-Buttons).
  9. Liefere die Dateipfade und sage der Person, was sie durch Anhören überprüfen muss (du hörst kein Audio). Niemals veröffentlichen.
  10. Vor-Veröffentlichung (optional, nach bestandener QA): Redaktionelle QA je Dimension (py creative-intelligence/ci.py avaliacao modelo ...), Hakenvergleich zwischen Versionen (ci comparar) und prädiktive Bewertung (Higgsfield) nur mit Kostenfreigabe und Genehmigung des Materialeigentümers (ci prever ... --modelo-autorizacao). Siehe Skill engenharia-reversa, Abschnitt 5. Weder für Aufnahmen noch für Tutorials erforderlich; der Motor hängt nicht davon ab.

Bildblatt (alle 2 s): ffmpeg -i saida/<video>.mp4 -vf "fps=1/2,scale=240:427,tile=9x3" -frames:v 1 folha.png.

Tutorial-Modus (echte Webseite)

Kopiere modelos/roteiro_modelo.py nach videos/<ordner>/roteiro.py; Aktionen in docs/02_ACOES_DO_ROTEIRO.md. Teste py motor/gravar.py videos/<ordner> --so 02-04; dann das gesamte Video.

Regeln, die schon teuer waren (nicht wiederholen)

  • render(t) hängt nur von t ab (nichts aus dem vorherigen Frame gespeichert); Verlaufsstopps immer in Reihenfolge.
  • Niemals einfrieren: Kamera immer in Bewegung (langsame Annäherung + Drift); Clip, der endet, läuft rückwärts wieder von hinten; Endkarte bewegt sich.
  • Aktion im 1. Frame: Die erste Sekunde zeigt bereits das Geheimnis (keine leere Szene, die wartet).
  • Reels (1080 × 1920): Titel zwischen 150 und 440 px; Untertitel bei ~1330 px mit maximal ~16 Zeichen pro Block (Sperre bei 860 px); nichts Wichtiges unterhalb von 1600 px noch rechts (x > 960) zwischen 1100 und 1750 px – Instagram-Buttons und -Beschreibung.
  • Das Demonstrationsobjekt muss groß sein: Kamera nah heran; Gras/Elemente im Vordergrund nur an der Basis des Objekts.
  • Vergleich "vorher × nachher" mit gleichem Bildausschnitt in beiden Frames; sichtbarer Übergang zwischen ihnen (z. B. Wisch-Effekt).
  • Im Hochformat keine waagerechte Leiste in der Mitte; waagerechter Clip wird im Hochformat beschnitten (max. Vergrößerung ~1,2×).
  • PNG der Figur: Prüfe, ob der Hintergrund wirklich transparent ist (5% Farbe wird zu einem Rechteck im Video).
  • Absichtlicher Zoom kann Text für < 0,5 s aus dem Bild nehmen; ansonsten muss die Textprüfung sauber sein.
  • Verwende weder den Screencast des Browsers noch das Playwright-Video (beide unscharf); der Motor fotografiert Frame für Frame.
  • Windows-Pfad in roteiro.py immer als r"...".
  • Stimme: kurze Sätze; vozes.py erzeugt Satz für Satz mit Atempause (voz["respiro"]). Natürliches Tempo 2,4 bis 3,2 Wörter/s (der Motor zeigt die Dauer; Wörter ÷ Sekunden).
  • Bildmaterial-Clips: Nur Lizenzen, die die Nutzung erlauben (Mixkit "Free"; "Restricted" verbietet Werbung); in midia/CREDITOS.md eintragen.

Sicherheit

  • Die Sprache geht an einen externen Dienst (Edge TTS oder ElevenLabs): Niemals Namen, CPF oder Kundendaten in den gesprochenen Text setzen.
  • Schlüssel nur in ~/.secrets/ (ElevenLabs: ~/.secrets/elevenlabs/.env); niemals ausgeben, niemals ins Repository kopieren.
  • Simulation oder fiktive Figur: Auf dem Bildschirm kennzeichnen ("ungefähre Simulation", "fiktive Figur").
  • Kein bezahltes API-Guthaben ohne Zustimmung des Benutzers ausgeben.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills