Mintii-Labs/ozor-skills

Ozor Generate (Text-zu-Video)

End-to-End-Videogenerierung auf Ozor.ai mit den mcp__ozor__*-Tools. Dieser Skill nimmt eine kurze kreative Beschreibung entgegen und liefert ein fertiges, exportiertes, teilbares Video – nicht nur einen Prompt.

Wann verwenden

Verwende diesen Skill, wenn der User tatsächlich ein Video produzieren möchte, basierend auf einer kurzen Textidee. Signale:

• „Erstelle ein Video über ...“
• „Generiere ein Launch-Video für ...“
• „Erstelle einen 30-Sekunden-Erklärer über ...“
• „Erstelle einen Werbespot für unsere neue Funktion ...“
• „Rendere ein Video, das sagt ...“

Verwende diesen Skill NICHT, wenn:

• Der User ein Dokument, PDF, PPTX, DOCX, Deck oder eine Datei hat → verwende ozor-document-video
• Der User eine URL / Landing Page angibt → verwende ozor-url-to-video
• Der User nur Hilfe beim Schreiben eines Ozor-Prompts ohne Generierung möchte → verwende ozor-video-best-practices
• Der User vorhandene Videos verwalten möchte → verwende ozor-video-library

Erforderliche MCP-Tools

Dieser Skill setzt voraus, dass das Ozor MCP verbunden ist. Die Tools sind:

• mcp__ozor__generate_video – startet einen Text-zu-Video-Job
• mcp__ozor__wait_for_job – blockiert, bis der Agent das Projekt fertig gebaut hat
• mcp__ozor__export_video – startet den Render
• mcp__ozor__wait_for_export – blockiert, bis der Render fertig ist, gibt URLs zurück
• mcp__ozor__get_embed_code – gibt das <iframe>-HTML zurück
• mcp__ozor__list_voices – optional, Abfrage verfügbarer Stimmen
• mcp__ozor__send_message – optional, nachträgliche Änderungen am Video-Agenten

Wenn das Ozor MCP nicht verbunden ist, teile dem User mit, es hinzuzufügen, und breche ab – versuche nicht, auf eine reine Prompt-Ausgabe zurückzufallen.

Workflow

Schritt 1 — Die Beschreibung formen

Der Ozor-Prompt ist auf 2000 Zeichen begrenzt und sollte ein kurzes Video beschreiben. Stelle vor dem Aufruf des MCP sicher, dass die Beschreibung Folgendes enthält:

• Worum geht es im Video in einem Satz
• Zielgruppe (Gründer:innen, Entwickler:innen, Kund:innen, allgemeine Öffentlichkeit, ...)
• Format – 16:9 (Standard, Querformat) oder 9:16 (Hochformat für Social Media)
• Ungefähre Dauer – typischerweise 15–90 Sekunden
• Anzahl der Szenen (3–6 ist der optimale Bereich)
• Ton (selbstbewusst, warmherzig, energiegeladen, technisch, ...)
• Visueller Stil (dunkel/hell, Farbakzent, minimalistisch/kühn)
• Ein klarer CTA für die letzte Szene

Wenn etwas davon fehlt UND die Lücke das Ergebnis wesentlich verändert, stelle eine gezielte Frage. Ansonsten wähle einen sinnvollen Standardwert und fahre fort – Autopilot-Verhalten.

Füge niemals ein mehrszeniges Skript aus einem Dokument in diesen Prompt ein. Das überschreitet die 2000-Zeichen-Grenze und verliert die Folienvisualisierungen. Für Dokumente wechsle zu ozor-document-video.

Schritt 2 — Generieren

Aufruf:

mcp__ozor__generate_video({
  prompt: "<die zusammengestellte Beschreibung, unter 2000 Zeichen>",
  export: true   // empfohlen: löst den Export automatisch aus, sodass Schritt 4 übersprungen werden kann
})

Dies gibt { videoId, jobId } zurück. Teile dem User mit, dass der Job gestartet wurde und du darauf wartest.

Schritt 3 — Auf den Build warten

Aufruf:

mcp__ozor__wait_for_job({ videoId, jobId })

Dies blockiert, bis der Ozor-Agent das Projekt fertig gebaut hat. Bei einem Fehler sagt die Fehlermeldung normalerweise, was im Prompt zu korrigieren ist – leite sie an den User weiter und biete an, es mit Anpassungen erneut zu versuchen.

Schritt 4 — Exportieren (überspringe, wenn du export: true übergeben hast)

Falls du in Schritt 2 kein export: true übergeben hast, rufe auf:

mcp__ozor__export_video({ videoId })

Schritt 5 — Auf den Render warten

Aufruf:

mcp__ozor__wait_for_export({ videoId })

Dies gibt die endgültigen URLs zurück:

• shareUrl – öffentlicher Link zum gerenderten Video
• editorUrl – Ozor-Editor-Link für weitere Anpassungen
• downloadUrl – direkter MP4-Download

Schritt 6 – Embed-Code abrufen

Aufruf:

mcp__ozor__get_embed_code({ videoId })

Gibt einen fertig zum Einfügen bereiten <iframe>-Schnipsel zurück.

Schritt 7 — Ergebnisse dem User präsentieren

Ausgabe in diesem Format:

🎬 Video fertig

**Teilen:** <shareUrl>
**Editor:** <editorUrl>
**Download:** <downloadUrl>

**Embed:**
```html
<iframe ...></iframe>

Möchtest du iterieren? Ich kann:

• Eine bestimmte Szene ändern
• Einen anderen Ton oder visuellen Stil ausprobieren
• Eine 9:16 Social-Media-Version erstellen

## Iteration

Wenn der User nach dem Ergebnis Änderungen wünscht, verwende `mcp__ozor__send_message({ videoId, message: "<Änderungswunsch>" })` und führe dann die Schritte 3–6 erneut aus (der Agent baut das Projekt neu, du brauchst einen neuen Export).

Bei größeren Änderungen (anderes Thema, andere Zielgruppe) starte lieber einen neuen `generate_video`-Aufruf, anstatt zu iterieren – das Prompt-Budget ist klein und das Ändern im laufenden Projekt verwässert oft das Ergebnis.

## Standardwerte im automatischen Modus

Wenn der User eine einzeilige Beschreibung gibt und du ihn nicht ausfragen möchtest:

| Feld | Standard |
|------|----------|
| Format | 16:9 Querformat |
| Dauer | ~30 Sekunden |
| Szenen | 3–4 |
| Ton | Selbstbewusst, modern |
| Stil | Sauber, minimalistisch, mit einem Akzentfarbe |
| CTA | „Mehr erfahren“ mit Platzhalter-URL/Handle, falls nicht angegeben |

Gib die angenommenen Standardwerte in deiner Antwort an, damit der User sie korrigieren kann.

## Qualitäts-Checkliste vor dem Aufruf von `generate_video`

- [ ] Prompt ist unter 2000 Zeichen
- [ ] Ein klares Thema, kein Multi-Thema-Aufsatz
- [ ] Hook in Szene 1 genannt
- [ ] CTA in der letzten Szene genannt
- [ ] Visueller Stil + Ton + Zielgruppe angegeben
- [ ] Kein kopierter Text aus einem Dokument – das ist die Aufgabe von `ozor-document-video`

## Fehler und Wiederherstellung

- **MCP nicht verfügbar** → teile dem User mit, dass das Ozor MCP nicht verbunden ist, und breche ab. Falle nicht auf das Schreiben eines Papier-Prompts zurück.
- **`generate_video` schlägt fehl (Prompt zu lang)** → kürze die Beschreibung, entferne redundante Stilnotizen, wiederhole.
- **`wait_for_job` gibt einen Fehler zurück** → gib den Fehler wörtlich weiter, schlage eine Lösung vor (oft: Prompt vereinfachen, mehrdeutige Szenenanweisungen entfernen) und biete einen erneuten Versuch an.
- **`wait_for_export` läuft aus** → es ist sicher, den Aufruf zu wiederholen; der Export wird ab dem Punkt fortgesetzt, an dem Ozor aufgehört hat.

## Regeln

1. **Führe das MCP tatsächlich aus.** Dieser Skill existiert, um ein Video zu produzieren, nicht einen Prompt. Wenn du nur Text zurückgibst, hast du den Skill nicht erfüllt.
2. **Stelle nicht 5 klärende Fragen.** Stelle maximal eine gezielte Frage, dann setze den Rest auf Standardwerte.
3. **Zeige jede URL an.** `shareUrl`, `editorUrl`, `downloadUrl` und das Embed sind alle in verschiedenen Kontexten wertvoll – zeige sie alle.
4. **Respektiere die 2000-Zeichen-Prompt-Grenze.** Wenn deine Beschreibung sie überschreitet, kürze sie vor dem Senden.
5. **Verwende standardmäßig `export: true` in `generate_video`** – ein Toolaufruf weniger, schneller zum fertigen Video.