Kingsizestrj/SKILLS

Realistische KI-Videos von Voltec mit der Markenpersona (ElevenLabs + HyperFrames)

Produktion und Bearbeitung jedes realistischen KI-Videos von Voltec mit der Markenpersona (Reels, Stories oder 9:16-Anzeige, für jede Kampagne, Jahreszeit, jedes Thema oder Szenario): KI-Persona an einem realen Ort → genehmigter Snapshot → Veo 3.1 Image-to-Video → Vertonung mit Klonstimme → HyperFrames-Bearbeitung mit Untertiteln, CTA und QR-Code. Hier finden Sie den Ablauf, die Regeln, die festen Voltec-Parameter und die Slots, die sich bei jedem Video ändern. JSON-Strukturen, vollständige Prompts und lange Befehle befinden sich in references/.

Getesteter Referenzfall: der Reel „Verão Conectado“ (15.10.2026; 20,5 s, 1080x1920, 24 fps; ausgeliefert in v5). Seine Werte erscheinen als „z.B. Verão Conectado“ und sind niemals Standard: Was zur Kampagne gehört, ist ein Slot (§1b), und das ausgefüllte Beispiel befindet sich in §7.2.

• [Voltec] markiert, was für Voltec mit der Persona oder dem versorgten Gebiet (Grussaí und Region) festgelegt ist. „Z.B. Verão Conectado“ markiert einen Wert, der nur zur Referenzkampagne gehört. Der Rest gilt für jede KI-Anzeige.
• Evidenzstufe, wie in den Referenzen: [vivido] ist in der Sitzung passiert und wurde überprüft; [aplicado] stammt aus der Recherche oder den Kritiken und wurde in die genehmigten Takes aufgenommen; [pesquisa] nur aus der Recherche; [não testado] aus den Regeln abgeleitet, ohne Generierung (§8).
• $SKILL = Ordner dieser SKILL.md; $PROJ = Ordner des Videoprojekts. Shell-Variablen werden nicht von einem Bash-Aufruf zum anderen übergeben: Wiederholen Sie die Präambel aus Abschnitt 5 bei jedem Aufruf.
• Generierungsprompts auf Englisch. Texte für den Kunden, Erzählung und Untertitel auf Portugiesisch.
• Der API-Schlüssel befindet sich in ~/.config/elevenlabs/env (chmod 600) und scripts/el.py liest ihn, ohne ihn auszugeben. Verwenden Sie niemals echo, cat, env, curl -v oder set -x damit, und schreiben Sie ihn auch nicht in eine Datei, einen Prompt oder eine Nachricht.
• Sie hören kein Audio: Überprüfen Sie mit STT (Text und audio_event), einem Spektrogramm des Ausschnitts und ebur128, und listen Sie auf der Portão-Seite die Zeitpunkte auf, die der Kunde anhören soll.

1. Wann verwenden

• [Voltec] Jedes realistische KI-Video von Voltec mit der Markenpersona, das wie eine echte Aufnahme von jemandem aussehen soll: Reels, Stories oder Anzeige; jede Kampagne, Jahreszeit oder jedes Thema (saisonale Aktion, institutionell, Wi-Fi-Tipp, Support, Eröffnung, Black Friday); reales Szenario aus dem versorgten Gebiet (Grussaí, Atafona, Chapéu do Sol, São João da Barra; was als Szenario dient: §7.1) oder Innenaufnahme (Haus, Geschäft, Auto). Szenario, Kleidung oder Format, das noch nie generiert wurde: §8.
• Generierung über die ElevenLabs-API: Bild (Snapshot), Video (Veo 3.1; Seedance über die API nur mit Freigabe oder manuell in der App), Vertonung mit Klonstimme, SFX und STT.
• Bearbeitung in HyperFrames: Bild-für-Bild-Schnitte, Mischung, Karten, synchronisierte Untertitel, CTA und QR-Code.
• Anpassung eines bereits ausgelieferten KI-Videos: Ausschneiden eines Takes, Variation ändern, einen Satz oder den CTA ändern, Version mit Untertiteln, Identität verfeinern.
• Mit ihr, die in die Kamera spricht („sie spricht“, „sie sagt“, „sie erklärt“): Sprechmodus, in references/modo-falando.md. Veo 3.1 generiert den Take mit der Sprache und sts.py tauscht die Stimme gegen Radassa aus. [vivido: 13-Sekunden-Test am 15.10.2026 genehmigt]
• [ALLGEMEIN] Andere Marke oder Persona: Was nicht [Voltec] ist, gilt, mit Anpassung (ersetzen Sie §7.1 und füllen Sie die Slots aus §1b). Referenzprojekt: /home/syllas/hyperframes/voltec-reels-ia/ (Verão Conectado; schreibgeschützt).
• Nicht geeignet für Motion Graphics ohne Person oder ohne generierte Szene (dann reicht HyperFrames) noch für Voltec-Themen ohne Video (Netzwerk, GenieACS, TR-069).

Qualitätsstandard (Anforderung von Voltec; als Standard für jedes Projekt verwenden): maximale Realitätstreue; glaubwürdige Kamera, wie jemand, der wirklich filmt; reale Umgebung, ohne abrupte Wechsel; keine Anomalie am Objekt in der Hand; reale Orte mit lizenzierten Fotos (oder vom Kunden selbst), die dem Kunden gezeigt werden; Snapshots vor jedem Video genehmigt; detaillierte Prompts (Bewegung, Haut, Audioaufnahme mit echten Geräuschen); Recherche zu Best Practices vor der Generierung.

1b. Schnellstart: jedes neue Voltec-Video mit der Persona

1. Lesen Sie in dieser Reihenfolge: diese SKILL.md (mit §7) → persona-e-marca-voltec.md §1–4 und §6–7 → das Szenario: in Grussaí, locais-grussai.md §1, §3 (mit der Tabelle „Andere Jahreszeiten“) und §4; an einem anderen Ort oder Innenaufnahme, §8 dieser Datei, persona-e-marca-voltec.md §10 und locais-grussai.md §7–§10 → prompts-principios.md §1 (mit der „Prompt-Checkliste“) → nur die Vorlage von prompts-moldes.md §2, die der Szene am nächsten kommt (2.1 Freundin filmt, 2.2 Pose am selben Ort, 2.3 Selfie, 2.5–2.6 Video; neue Szene: 2.9–2.10). Den Rest nur in der Phase, in der er benötigt wird. prompts-moldes.md und persona-e-marca-voltec.md überschreiten das Limit einer einzigen Read-Operation: Finden Sie den Abschnitt mit Grep (z. B. ^### 2\.9, ^## 10) und lesen Sie mit Offset/Limit.
2. Bereits entschieden (Voltec-Festlegungen; nicht erneut fragen): Persona des Kontos, mit den Assets na7keiYvPpGArmyghOpk, pUgU1HXgmdqXfP02iR8T und ZY1iDcJLhPFklahPnvkM bereits im Konto (nicht erneut hochladen; Persona §4) und den Ankerpunkten für Gesicht, Haut und Hände (Persona §3.1–3.3); Stimme „Radassa 100%“ 4yvYc2GSakxLWMhlsd6b, eleven_v4, 0.45/0.85, "pt", und der A/B-Vergleich erfolgt nun zwischen 2 Seeds dieser Stimme; Aussprache vol-TÉC („Voltéc“ im TTS, „Voltec“ auf dem Bildschirm); kein Schmuck, keine Tattoos; keine Musik; Logo, Farben, Schriftarten und Städte (§7.1); die Regeln für Realismus, Prompt und QA (§3, qa-checklist.md) und die Portões (§2). Modell: Veo 3.1 über die API, ausgewählt am 15.10.2026; kehren Sie nur zur Frage zurück, wenn der kostenlose Zugangstest (modelos-e-custos.md §2.2) oder die Katalogüberprüfung von Phase 1 die Situation ändern.
3. Video-Slots: Fragen Sie immer, bevor Sie die Erzählung schreiben (im Chat reicht es). Ausgefülltes Beispiel in §7.2.
   • Vom Kunden (niemals erfinden): Thema und Format (Reels, Stories, Anzeige); Erzählung aus dem Off (Standard) oder sie spricht in die Kamera (references/modo-falando.md), und in diesem Fall der Text jedes Takes; Angebot, Preis, Bedingungen und Zeitraum; bezahlte Anzeige (Button „Mehr erfahren“ + QR-Code) oder organischer Beitrag („Link in der Bio“); Ziel des QR-Codes (die page_id=674 ist die Seite „Verão Conectado 2026“: nicht ohne Bestätigung des Kunden wiederverwenden); ob die Credits der CC BY-Fotos in der Beitragsbeschreibung stehen.
   • Fragen und vorschlagen (der Kunde genehmigt in Portão 1 oder 2): Szenario, Uhrzeit und Licht; Dauer; Drehbuch der Takes (pro Take: Ort, Objekt in der Hand und Umgebungsgeräusche); Kleidung; Hook; Kampagnenkarte; Text der SFX-Atmosphäre.
4. Pro Szene, Jahreszeit oder Szenario neu erstellen (nichts davon aus dem Beispiel kopieren): Kleidungsanker im Stil der Persona §3.4 (undurchsichtig, ohne Muster oder Logo; glatter Stoff oder mit grober Webart, da feine Muster flimmern); Licht durch die berechnete Sonne für Ort, Datum und Uhrzeit (locais-grussai.md §8; in Grussaí die Tabelle „Andere Jahreszeiten“ aus §3: im Winter, Sonne bei ~19,5° gegen 15:40 Uhr und Nachmittagssonne bei ~293–304°; bei der Selfie im Gegenlicht geht sie nach Süden und das Meer ist rechts); Wind (nur der Sommerwind wurde recherchiert: vorher recherchieren); Umgebungsgeräusche des Ortes (im Videoprompt und in der SFX-Atmosphäre); Ortsabschnitte im negative_prompt (prompts-moldes.md §2.6); Freiraum im Snapshot für den Hook, in einem glatten Bereich des Bildes (die #q1 der Vorlage ist oben rechts; z.B. Verão Conectado: offener Himmel in T1); Kampagnentexte in den Tokens __…__ der Vorlage: Hook, Kartentitel in 1 oder 2 Teilen mit optionalem Icon (z.B. „VERÃO ☀ CONECTADO“, mit der Sonne) und Angebot; Text der SFX-Atmosphäre.
5. Neues Projekt und neue Seite: $HOME/hyperframes/<kampagne> und ein neues Artifact. Nicht auf der URL von Verão Conectado neu veröffentlichen (§7.2).

2. Ablauf in Phasen und Portões

Jeder Portão ist eine Seite (Artifact) mit A/B nebeneinander und nummerierten Fragen. Fordern Sie eine kurze Antwort im Format "T1-A, T2-A, T3-A, Stimme A, Modell 1"; so wurden die Entscheidungen beschleunigt.

• Seite: eine pro Projekt, bei jedem Portão neu veröffentlicht (gleiche Datei, gleiche URL), mit dem aktuellen Portão oben und den bereits getroffenen Entscheidungen darunter; neue Kampagne = neue Seite. Medien werden als Support-Dateien in media/ abgelegt: Snapshots als JPG (~200 KB pro Stück in der Sitzung), Erzählung als MP3 und Vorschau des Videos als MP4 mit Poster-JPG (~11 MB in der Sitzung; Limit 15 MB pro Datei). Modellstruktur (z.B. die Seite von Verão Conectado): lesen Sie https://claude.ai/artifact/MivTjGgrZ9ZyhZTftP66kh (Artifact, action: "read"). Pro Take: A/B, Kamera, Aktion, aufgenommener Ton, Erzählung, Bildschirmtext und Zeit. Danach: Erzählung A/B mit Zeittabelle, Modellpfaden, Orten mit Credit und einem Kästchen mit dem Antwortformat.
• Protokoll: Notieren Sie die Antworten jedes Portões in $PROJ/DECISOES.md und im Bereich "Entscheidungen" der Seite.
• Portões zusammenführen: Führen Sie Portão 1, 2 und 3 auf einer Seite zusammen, wenn Angebot, CTA (bezahlt × organisch) und QR-Ziel bereits beantwortet sind. Ohne dies führen Sie zunächst Portão 1 durch (im Chat reicht es) und generieren weder Snapshot noch Erzählung. Die in einem Storyboard vor den Antworten gezeigte Erzählung ist vorläufig: Generieren Sie nach den Antworten (Aussprache, CTA, Angebot) die endgültige Erzählung mit der ausgewählten Stimme (2 Seeds, ~300 Credits pro Stück), vor den Videos. Z.B. Verão Conectado: narracao_radassa100 im Storyboard und narracao_v2_A_s1 nach den Antworten.
• Niemals kombinieren: Video vor dem OK von Portão 3.

Phase 1. Recherche und Plan (0 Credits)

• Recherchieren Sie parallel (4 Fronten: Modelle, Realismus/Anti-Halluzination, Orte und API; mit Unteragenten parallel, falls vorhanden). Schreiben Sie dann das Drehbuch und den Take-Plan im Storyboard-Format: pro Take, Ort und Uhrzeit, wer filmt und Kamera, Aktion in 2–3 Zeiten, Objekt, aufgenommener Ton, Satz der Erzählung, Bildschirmtext und Zeit.
• Führen Sie 2 unabhängige Kritiken durch, bevor Sie Credits ausgeben: ein Unteragent pro Fokus; ohne Unteragenten, einen separaten Durchlauf pro Fokus. Technik = Felder und Limits der API (api-elevenlabs.md §3.3), Dauer/1080p, Kosten und Moderation (prompts-principios.md §4). Realismus = „Prompt-Checkliste“ aus prompts-principios.md §1 + Licht und Geometrie (berechnete Sonne in locais-grussai.md §8; Innen- oder Nachtszene: §8 dieser Datei). Jede gibt Problem, Take, Schweregrad und Korrektur zurück.
• Rankings ändern sich schnell: Wenn modelos-e-custos.md älter als ~2 Monate ist, konsultieren Sie es erneut. Ab 17.11.2026 prüfen Sie, ob veo-3.1-generate-001 noch existiert. Testen Sie den Zugang zu jedem Modell, ohne Credits auszugeben (§2.2 derselben Datei).
• Kunde bereits bedient: Die Referenzen sind die Recherche. Wiederholen Sie nur den obigen Punkt und was an der Kampagne neu ist: Jahreszeit (der Wind außerhalb des Sommers wurde nicht recherchiert), Szenario außerhalb des Beispiels oder ohne offenes Foto (fordern Sie Fotos vom Kunden an, locais-grussai.md §7; was nicht recherchiert wurde, steht in §8 und in locais-grussai.md §10), Kleidung und Objekt in der Hand (Persona §3.4). Behalten Sie die 2 Kritiken vor der Ausgabe bei.
• Portão 1, der Kunde erhält: empfohlenes Modell mit datiertem Ergebnis und voraussichtlichen Kosten; Drehbuch mit geschriebener Erzählung; nummerierte Fragen: CTA für bezahlte Anzeige oder organischen Beitrag, QR-Ziel, Aussprache der Marke, Angebot und Preis (vom Kunden; niemals erfinden), Persona und Referenzen (weisen Sie darauf hin, wenn eine Referenz ein anderes Gesicht hat), Stimme und Zustimmung, Musik (Standard: ohne), Dauer, Tattoos und Schmuck, Label „KI-Informationen“, Credit der Fotos. [Voltec] Fragen Sie nur das, was Abschnitt 1b vorgibt.

Phase 2. Reale Orte (0 Credits)

• Fotos mit der auf der Fotoseite gelesenen Lizenz und dem nachgewiesenen Ort (Geotag, OpenStreetMap): Methode in locais-grussai.md §7. Berechnen Sie die Sonne für die Uhrzeit der Szene (locais-grussai.md §8) und prüfen Sie den Wind am Ort. Nur CC0 und CC BY gehen zur API; NC-Foto dient nur als Referenz zum Schreiben des Prompts. Innenaufnahme (Haus, Geschäft, Auto): Fotos des Kunden selbst, ohne lesbares Nummernschild oder Schriftzug (§8).
• Portão 2, der Kunde erhält: Kontaktbogen (grün = kann zur API; rot = NC), Credits, das vorgeschlagene einzelne Szenario (ein Ort und eine Uhrzeit; z.B. Verão Conectado: die Veranda und der Sand davor, an einem Sommernachmittag) und die Uhrzeit des Lichts.

Phase 3. Snapshots und Erzählung (obligatorischer Portão)

• Snapshot = 1. Bild jedes Takes, im gpt-image-2.5-sunburst (9:16, 2K, high), mit 2 Variationen pro Take. Überprüfen Sie alle mit qa-checklist.md §A.
• Generieren Sie zuerst T1 A/B. Wählen Sie selbst die beste mit qa-checklist.md §A aus und verwenden Sie sie als Basis: Der nächste Take am selben Ort ist eine Bearbeitung davon, mit der Kamera am selben Punkt; neuer Ort ist ein neues Bild mit ihr als Image 1 (z.B. Verão Conectado: T2 und T3 stammen aus T1-A 5vBTv3B9FOt44Vu8jMY4 vor dem Storyboard). Geben Sie in Portão 3 an, welche Takes von T1-X abgeleitet sind. Wenn der Kunde das andere T1 wählt, erstellen Sie die Ableitungen daraus neu (2 Bilder pro Take; z.B. Verão Conectado: T2 und T3, 4 Bilder, ≈2.200 Credits) vor jedem Video.
• Ganze Erzählung in einer Anfrage, mit 2 Stimmen oder 2 Seeds. Die vom Alignment gemessene Dauer bestimmt die Schnitte. Überprüfen Sie die Betonung der Marke und den gesprochenen Text (stress.py + STT).
• Portão 3, der Kunde erhält: A/B jedes Takes nebeneinander mit der Gesichtsreferenz, Player der Erzählung A/B, die Fotos der Orte und die Frage zum Modell. Halten Sie bis zur Antwort an und speichern Sie die genehmigten generation_id.

Phase 4. Videos, 2 Variationen pro Take

• Veo 3.1, start_frame = generation_id des genehmigten Snapshots, 9:16, 1080p, 8 s, mit Audio, Seeds 20260115 und 20260116. Der Prompt beschreibt nur Bewegung, Kamera und Ton (prompts-moldes.md §2.5–2.6). Die Persona spricht nicht, außer im Sprechmodus (references/modo-falando.md §4).
• 19.391 Credits pro Generierung, 2 pro Take (z.B. Verão Conectado, 3 Takes × 2 Variationen = 116.346). In der Sitzung waren 6 parallele Generierungen in ~3 Minuten fertig (variiert). Der Kunde erhält in dieser Phase nichts.

Phase 5. Auswahl und QA jeder Variation (interner Portão)

• Kontaktbogen mit 2 fps, nummerierte Streifen mit 24 fps (Mund) und 8 fps (Hände und Objekt), und STT des nativen Audios (qa-checklist.md §B). Notieren Sie das Bild jedes Fehlers (Take Veo = 192 Bilder; Bild = Sekunden × 24) und wählen Sie einen In/Out-Punkt, der ihn vermeidet. Wenn Variation A kein sauberes Fenster hat, verwenden Sie B. Wenn beide fehlschlagen, generieren Sie neu, indem Sie EINE Variable ändern.
• Neu generieren über die 2 Variationen hinaus: innerhalb der in Portão 1 genehmigten Reserve von 1 Runde; darüber hinaus, holen Sie OK mit Grund und Kosten ein (19.391 pro Take).
• Der Kunde erhält hier nur etwas, wenn es einen echten Zweifel gibt: die 2 Variationen in einer Schleife auf der Seite.

Phase 6. Bearbeitung (0 Credits, außer der SFX-Atmosphäre)

• Bringen Sie alle Takes im richtigen A/B-Zustand in die HyperFrames-Timeline. Schneiden Sie die Enden der Veo-Generierung (0,5 s Ein- und Ausblenden des Logos).
• Synchronisieren Sie die Erzählung mit der Bewegung der Persona (Alignment).
• Fügen Sie Überleitungen, Karten, Untertitel, CTA und QR-Code hinzu.
• Mischen Sie die SFX-Atmosphäre.
• Portão 4 (falls zutreffend): Der Kunde erhält einen Videoplayer mit Auswahlmöglichkeiten.

Phase 7. Auslieferung (0 Credits)

• Exportieren Sie das endgültige Video in 1080x1920, 24 fps, H.264.
• Erstellen Sie eine Vorschau in der Seitenleiste.
• Abschluss: Der Kunde erhält die endgültige Datei.

3. Realismus, Prompt und Qualitätssicherung

• Prompt-Checkliste (prompts-principios.md §1): Detaillierte Beschreibung der Bewegung, Haut, Audioaufnahme.
• Kamera-Checkliste: Handheld-Look, kein Stativ, natürliches Wackeln.
• Umgebungs-Checkliste: Keine abrupten Wechsel, konsistente Beleuchtung.
• Objekt-Checkliste: Keine Anomalien am Objekt in der Hand.
• Audio-Checkliste: Echte Umgebungsgeräusche, keine künstliche Stille.
• Sicherheits-Checkliste: Keine sensible Daten im Prompt.

4. Fehlerbehebung

• Snapshot nicht genehmigt: Prompt verfeinern, neue Variation generieren.
• Video fehlerhaft: Variation wechseln, Regenerierung anfordern.
• Audio nicht synchron: Neu mischen, Alignment prüfen.
• QR-Code ungültig: URL prüfen, Code neu generieren.

5. Arbeitsspeicher und Grenzen

• Snapshots: ~200 KB pro Stück.
• Videos: ~11 MB pro Stück.
• Sitzung: maximal 15 MB pro Datei.
• Credits: 19.391 pro Generierung.

6. Referenzen

• references/modo-falando.md
• references/persona-e-marca-voltec.md
• references/locais-grussai.md
• references/prompts-principios.md
• references/prompts-moldes.md
• references/qa-checklist.md
• references/modelos-e-custos.md
• references/api-elevenlabs.md