Zurück zur VidCraft-Hauptseite
Dieses Beispiel führt durch den kompletten VidCraft-Workflow an einem realen Use Case: Ein OXID-Gallery-Plugin existiert mit README-Dokumentation, und wir produzieren daraus eine 3-teilige Tutorial-Serie für YouTube.
Ausgangslage:
mmd_gallery (fiktiv, aber realistisch nach OXID-Konvention)~/projekte/oxid-gallery/README.md (3.520 Wörter, 12 Sektionen)Output am Ende:
/vidcraft:doc-analyzer ~/projekte/oxid-gallery/README.md tutorial
Output (gekürzt):
Document Analysis: oxid-gallery README.md
Stats: 3.520 Wörter, 12 Sektionen, 18 Code-Blöcke
Empfehlung:
- Video-Typ: Tutorial-Serie (3 Episoden)
- Ep 01: Installation
- Ep 02: Konfiguration
- Ep 03: Theming + Troubleshooting
- Geschätzte Dauer: 8-12 min total
- Audience: Mid-level Shop-Admin
Schlüsselpunkte:
1. [HIGH] OXID Gallery braucht PHP 8.1 + OXID 7.0
2. [HIGH] Composer-Install aktiviert nicht automatisch
3. [MID] Theme-Override über bin/oe-console
4. [MID] Fancybox 5 (LGPL) als Lightbox-Lib
/vidcraft:new-project "OXID Gallery Tutorial" tutorial
Output:
Projekt angelegt: oxid-gallery-tutorial
Pfad: ~/video-projects/projects/oxid-gallery-tutorial/
Status: Concept
/vidcraft:audience-researcher oxid-gallery-tutorial
Output (gekürzt):
# Audience: oxid-gallery-tutorial
## Persona 1: "Maria, OXID-Shop-Admin"
- 35, Junior Developer in einem Mittelstand-E-Commerce
- Erfahrung: 2 Jahre OXID, kennt Composer
- Pain: Plugin-Installation hat oft Theme-Konflikte
- Knowledge-Level: mid (versteht "Composer", "Module-Activation")
- Motivation: Plugin schnell live, ohne Bugs
## Persona 2: "Tom, Senior-Dev"
- 42, technical lead bei Agency
- Erfahrung: 8 Jahre OXID, kennt OXID 4 + 6 + 7
- Pain: Plugin-Doku oft veraltet, Konflikte bei Updates
- Knowledge-Level: high (versteht "Container-Cache", "DI", "Twig-Override")
- Motivation: Sauberer Code, klare Architektur-Entscheidungen
/vidcraft:project-conceptualizer oxid-gallery-tutorial
Output (gekürzt):
# Konzept: OXID Gallery Tutorial
## Goal
Shop-Admins durch die komplette OXID-Gallery-Installation und
-Konfiguration begleiten, mit Fokus auf häufigste Fehlerquellen.
## Tonality
- Sachlich, nicht herablassend
- Geduldig — auch Mid-Admin macht Composer-Fehler
- Direkt, kein Marketing-Sprech
## Episoden-Klammer
Ep 01: Installation (Setup + Activation)
Ep 02: Konfiguration (Settings + Lightbox)
Ep 03: Theming + Troubleshooting (Customizing + Fixes)
## Visuelle Identität
- Brand-Farben: #2563EB (Primary), #10B981 (Secondary)
- Avatar: Anna_Professional (HeyGen)
- Lower-Third: "MMKreativ — OXID Gallery"
/vidcraft:brief-creator oxid-gallery-tutorial
Output:
# Creative Brief: OXID Gallery Tutorial
## Goals
- Reduzierung der Support-Tickets zu Plugin-Installation um 50%
- 1.000 Views pro Episode in 30 Tagen
- 5+ "Hat geholfen!"-Kommentare pro Episode
## Audience
- Primary: OXID-Shop-Admins (Maria-Persona)
- Secondary: Senior-Devs (Tom-Persona)
## Tone & Style
- Sachlich, geduldig, direkt
- Keine Memes, kein Hype
- Code im Vordergrund, Avatar als Begleitung
## Constraints
- HeyGen, max 1.500 Zeichen pro Szene
- Episoden max 5 min (YouTube-Algorithmus)
- DE-First, EN-Subtitles
## Key Messages
1. Plugin korrekt installieren (Composer + Activation)
2. Konfiguration ist defensiv (Defaults sind safe)
3. Bei Theme-Konflikten: bekannte Fixes anwenden
/vidcraft:script-writer oxid-gallery-tutorial 01-installation
Output (Auszug):
---
episode_id: 01-installation
title: "OXID Gallery installieren"
status: Script Draft
target_duration: "3-4 min"
target_wpm: 130
target_words: 390-520
---
# Episode 01: OXID Gallery installieren
## Scene 01 — Hook (5s, ~12 Wörter)
**Narration:**
OXID Gallery installiert sich in acht Minuten — wenn du die richtigen
Dependencies hast. Hier sind sie.
**Visual:** [zoom] Logo OXID Gallery, dann [highlight] PHP-Version
## Scene 02 — Voraussetzungen (25s, ~55 Wörter)
**Narration:**
Du brauchst PHP 8.1 oder höher, OXID 7.0 oder neuer, und Composer 2.5+.
Wenn du eines davon nicht hast — pause das Video, installier es,
und komm wieder. Ich warte.
[pause 0.5s]
**Visual:** [screencast] Terminal: `php --version`, dann `composer --version`
## Scene 03 — Composer Install (60s, ~130 Wörter)
**Narration:**
Erster Schritt: composer require mmd/gallery in deinem OXID-Root.
[pause 0.3s]
Composer lädt das Plugin in vendor/mmd/gallery.
Das aktiviert es aber noch NICHT — und das ist der häufigste
Stolperstein.
[pause 0.5s]
Aktivieren musst du es über `bin/oe-console oe:module:activate mmd_gallery`.
Das registriert das Plugin im OXID-Container und aktiviert die
Default-Templates.
**Visual:** [screencast] Terminal mit beiden Commands, dann
[highlight] Erfolgs-Output "Module activated successfully"
## Scene 04 — Verification (20s, ~45 Wörter)
**Narration:**
Verifikation: Geh in die OXID-Admin → Erweiterungen → Module.
mmd_gallery sollte als "aktiv" angezeigt werden.
Wenn nicht: Container-Cache leeren mit `bin/oe-console oe:cache:clear`.
**Visual:** [screencast] OXID-Admin "Module"-Liste, [highlight] mmd_gallery
## Scene 05 — Outro/CTA (15s, ~35 Wörter)
**Narration:**
Plugin ist installiert. Im nächsten Video konfigurieren wir die
Default-Galerie und richten die Lightbox ein.
[pause 0.3s]
Bis gleich.
**Visual:** [outro-frame] mit Brand-Logo + "Episode 02 next"
Wort-Anzahl: 277 (Ziel: 390-520) — etwas knapp, kommt im Review.
/vidcraft:script-reviewer oxid-gallery-tutorial 01-installation
Output:
## Script Review: Episode 01
### 14-Point Quality Check
- [x] 1. Timing — 277 Wörter / 130 WPM = 2:08
⚠️ Unter Ziel-Dauer (3-4 min) → Erweitere Verification-Szene
um häufige Composer-Fehler
- [x] 2. Readability — Flesch 67 ✓
- [x] 3. Struktur — Hook → Prereqs → Steps → Verification → CTA ✓
- [x] 4. Hook — "OXID Gallery installiert sich in 8 Minuten — wenn..."
✓ Konkret, kein "In diesem Tutorial..."
- [x] 5. CTA — "Im nächsten Video..." einzeln klar ✓
- [x] 6. Tonalität — sachlich, geduldig ✓
- [x] 7. AI-Sprache — keine Findings ✓
- [x] 8. Satzlänge — Median 13, Max 18 ✓
- [x] 9. Szenen-Dauer — Längste 60s (Scene 03) ✓
- [x] 10. Übergänge — fade defined ✓
- [x] 11. Visual Cues — alle Szenen haben [zoom]/[screencast]/[highlight] ✓
- [x] 12. On-Screen Text — Max 5 Wörter ✓
- [x] 13. Jargon — "Container-Cache" einmal ohne Erklärung
→ Vorschlag: "Container-Cache (OXIDs interner Auflösungs-Speicher)"
- [WARN] 14. Zusammenfassung — fehlt vor CTA
→ Empfehlung: 10s "Zusammenfassung der Schritte" einfügen
## Overall: 12 / 14 — Revise before Generation
Critical: keine
Polish: 1 (Wörter), 13 (Jargon), 14 (Zusammenfassung)
User erweitert Script um 70 Wörter, fügt Zusammenfassung ein, glossiert "Container-Cache". Re-Run von script-reviewer zeigt 14/14.
/vidcraft:voice-checker oxid-gallery-tutorial 01-installation
Output:
Voice Check: 1 advisory finding
Z. 89: "der häufigste Stolperstein"
→ Cliché-grenzwertig (idiomatisch ok, aber im Tech-Kontext austauschbar)
→ Vorschlag: "der typische Fehler hier" oder konkret bleiben
User entscheidet: Stolperstein ist im DE-Tech-Sprech etabliert, bleibt. (Voice-Checker ist advisory.)
/vidcraft:storyboard-creator oxid-gallery-tutorial 01-installation
Output (Auszug):
# Storyboard: Episode 01
## Scene 01 — Hook
- **Visual:** Brand-Logo Animation (1.5s) → Code-Stream-Background mit "PHP 8.1+, OXID 7.0+, Composer 2.5+" als On-Screen-Text
- **Avatar:** Anna_Professional, Avatar-Position center, Speed 1.0
- **Background:** Dark code wallpaper (#0F172A, code-particles)
- **Transition zu Scene 02:** Cut
## Scene 02 — Voraussetzungen
- **Visual:** Split-Screen: Avatar links, Terminal rechts (live-typing animation)
- **Background:** Office (light), terminal full screen rechts
- **Avatar-Position:** left
- **Transition:** Match-Cut (Terminal-Inhalt zu Composer-Output)
## Scene 03 — Composer Install
- **Visual:** Full-Screen Terminal-Recording (vorab aufgenommen),
Avatar als Picture-in-Picture rechts oben (klein)
- **Background:** Terminal screen recording
- **On-Screen-Text:** "composer require mmd/gallery" zentriert (3s)
- **Transition:** Whip-Cut zu Admin-UI
[... Scene 04, 05 analog]
/vidcraft:screenshot-planner oxid-gallery-tutorial 01-installation
Output (ASSETS.md):
# Required Assets: Episode 01
## Screenshots
- [ ] composer-install.gif — Terminal recording (Scene 03)
- [ ] activate-module-output.png — `oe:module:activate` success
- [ ] admin-modules-active.png — OXID-Admin Module-Liste
## Screen Recordings
- [ ] terminal-php-version-check.mp4 (5s, Scene 02)
- [ ] composer-require-flow.mp4 (15s, Scene 03)
- [ ] cache-clear-fix.mp4 (10s, Scene 04 fallback)
## Brand Assets
- [x] logo-mmkreativ.svg
- [x] lower-third-template.png
- [x] outro-frame-ep02-next.png
User nimmt Screen-Recordings auf (OBS), screenshottet OXID-Admin und legt sie unter assets/episodes/01-installation/.
/vidcraft:asset-collector oxid-gallery-tutorial 01-installation
Output:
Asset Inventory: Episode 01
✅ All required assets present (8/8)
/vidcraft:pre-generation-check oxid-gallery-tutorial 01-installation
Output:
✅ Gate 1: Script Status = "Script Reviewed"
✅ Gate 2: 5 Szenen vorhanden
✅ Gate 3: Narration komplett
✅ Gate 4: Visual Direction in allen Szenen
ℹ️ Gate 5: Geschätzte Dauer 3:12 (Ziel: 3-15 min)
✅ HeyGen Validation:
Alle Szenen unter 1.500 Zeichen ✓
Avatar-Konsistenz ✓
Background-Anzahl ok ✓
🟢 PASSED — Ready for HeyGen
/vidcraft:heygen-engineer oxid-gallery-tutorial 01-installation
Output (heygen-format.md, Auszug):
# HeyGen Format: Episode 01
## Scene 01 — Hook
- Avatar: Anna_Professional_Front
- Voice: de-DE-KatjaNeural
- Speed: 1.0
- Background: dark-code-wallpaper.jpg
- Avatar Position: center
- Script: |
OXID Gallery installiert sich in acht Minuten — wenn du die
richtigen Dependencies hast. Hier sind sie.
## Scene 02 — Voraussetzungen
- Avatar: Anna_Professional_Front
- Voice: de-DE-KatjaNeural
- Speed: 1.0
- Background: office-light.jpg
- Avatar Position: left
- Script: |
Du brauchst PHP 8.1 oder höher, OXID 7.0 oder neuer, und
Composer 2.5+.
[pause 0.5s]
Wenn du eines davon nicht hast — pause das Video, installier es,
und komm wieder. Ich warte.
[... Scenes 03-05]
User kopiert das in HeyGen, lädt Brand-Assets hoch, aktiviert Avatar/Voice und klickt Generate.
Nach 8 Minuten Generierung lädt User das Video herunter, legt es nach output/episodes/01-installation/final.mp4.
/vidcraft:video-reviewer oxid-gallery-tutorial 01-installation
Output:
## Video Review: Episode 01
### Pacing (4/4) ✓
### Visual (3/4)
- [WARN] Background Scene 02 zu hell — Kontrast Avatar/Background wird flach
### Narration (4/4) ✓
### Brand (4/4) ✓
### Accessibility (4/4) ✓
## Overall: 19 / 20 — Approved with minor revision
Required: Background Scene 02 abdunkeln (re-render mit office-medium.jpg)
User re-rendert Scene 02 in HeyGen mit dunklerem Background, fügt das in die Final-Datei zusammen (oder rerendert komplett — bei HeyGen meist schneller als Editing).
/vidcraft:subtitle-generator oxid-gallery-tutorial 01-installation
Output:
Whisper Transkription läuft...
✅ output/episodes/01-installation/subtitles-de.srt (3.520 Zeichen)
Übersetzung läuft (DE → EN)...
✅ output/episodes/01-installation/subtitles-en.srt (3.180 Zeichen)
YouTube-tauglich: max 21 chars/sec eingehalten ✓
/vidcraft:promo-writer oxid-gallery-tutorial 01-installation
Output (Auszug):
# Promo: Episode 01
## YouTube Description
**OXID Gallery Plugin — Episode 01: Installation**
In dieser Episode installierst du das OXID-Gallery-Plugin in unter
8 Minuten. Wir gehen Schritt für Schritt durch:
✅ Voraussetzungen prüfen (PHP 8.1, OXID 7.0, Composer 2.5+)
✅ Composer-Install ausführen
✅ Modul aktivieren mit oe-console
✅ Verifikation in der OXID-Admin
✅ Häufiger Container-Cache-Fix
📺 Episode 02: Konfiguration → [Link]
📺 Episode 03: Theming → [Link]
🔗 Plugin-Repository: github.com/markus-michalski/oxid-gallery
🔗 OXID-Doku: https://docs.oxid-esales.com
#OXID #eCommerce #Tutorial #PHP
## Facebook
🚀 Neues OXID-Tutorial ist live!
OXID Gallery installieren — in unter 8 Minuten.
Ohne Frust, ohne Hicks, mit fixem Container-Cache-Fix.
[Link zu YouTube]
## Instagram
[Caption für Reel-Variante des Hooks]
OXID Gallery installieren — 8 Minuten, kein Stress.
Voller Tutorial-Link in Bio. ⬇️
#oxid #ecommerce #devlife
## X (Twitter)
OXID Gallery installieren in 8 Min.
Voraussetzungen ✓
Composer-Install ✓
Aktivierung (häufigster Fail!) ✓
Verifikation + Cache-Fix ✓
Tutorial: [link]
## LinkedIn
[B2B-Variante mit längerem Kontext + Audience-Targeting]
/vidcraft:thumbnail-director oxid-gallery-tutorial 01-installation
Output (Konzept):
# Thumbnail Concepts: Episode 01
## Concept A (recommended)
- Layout: 16:9
- Background: Dark code wallpaper (#0F172A)
- Foreground: OXID-Logo links, "GALLERY" rechts in Brand-Blue (#2563EB)
- Top-Banner: "EPISODE 01"
- Hauptelement: "INSTALL IN 8 MIN" — bold, weiß
- Anna-Avatar als kleiner Cutout rechts unten
## Concept B (Alternative)
- Layout: 16:9
- Background: Hand-on-keyboard photo (Stock)
- Overlay: Gradient Brand-Blue
- Hauptelement: "OXID GALLERY" — bold weiß
- Sub-Element: "Setup Guide ✅"
## Empfehlung
Concept A — weil Markus-Michalski-Tutorial-Branding klar bleibt
und Episoden-Nummerierung visuell auflöst.
/vidcraft:release-director oxid-gallery-tutorial 01-installation
Output:
# Release Plan: Episode 01
## Final QA Checklist
- [x] Video-Reviewer 19/20 → fixed
- [x] Brand-Checker passed
- [x] Accessibility-Checker passed (WCAG AA)
- [x] Subtitles DE + EN
- [x] Thumbnail finalisiert (Concept A)
- [x] Promo-Texte freigegeben
## Distribution
| Channel | Status | Date |
|---------|--------|------|
| YouTube | scheduled 2026-04-26 09:00 | unlisted bis Schedule |
| LinkedIn | manual post 2026-04-26 10:00 | — |
| FB Page | manual post 2026-04-26 10:30 | — |
| IG (Reel-Cut) | 2026-04-27 (separater Schnitt) | TODO |
| X (Thread) | manual post 2026-04-26 11:00 | — |
## Metadata
- Title: "OXID Gallery installieren — Tutorial Episode 01"
- Description: aus promo/01-installation.md
- Tags: oxid, ecommerce, tutorial, php, composer
- Category: 28 (Science & Technology)
- Visibility: Unlisted → Public 2026-04-26 09:00 UTC
- Subtitles: DE (default), EN (auto-translate disabled, our SRT)
- End-Screen: Episode 02 + Subscribe
- Cards: Episode 02 bei 2:30, Plugin-Repo bei 0:45
- Thumbnail: Concept A
## Status: Ready to publish
User uploadet zu YouTube, plant 2026-04-26 09:00 UTC. Episode 01 fertig.
Episoden 02 (Konfiguration) und 03 (Theming + Troubleshooting) folgen demselben Muster — nur Schritte 6-19 wiederholen.
Tipp: Bei Multi-Episoden-Projekten lohnt der
brand-checkerzwischen den Episoden, um Tone-Drift früh zu erkennen.
/vidcraft:brand-checker oxid-gallery-tutorial 02-konfiguration
Findings betreffen typischerweise: Lower-Third-Konsistenz, Tonality-Drift, Glossar-Compliance ("OXID eShop" vs. "OXID Shop").
| Phase | Skills | Geschätzt | Real (Markus, geübter Anwender) |
|---|---|---|---|
| Doc-Analyse + Konzept | 5 Skills | 30 min | 20 min |
| Episode 01 (Script→Approval) | 9 Skills | 90 min | 60 min |
| Episode 01 (Generation→Release) | 5 Skills | 60 min | 35 min |
| Episode 02 + 03 | je wie 01 | je 2.5h | je 90 min |
| Total | ~10h | ~5h |
Vergleich ohne VidCraft (aus Erfahrung): Reines ChatGPT + Manual-Workflow für 3 Episoden = ~15-20h, mit unsystematischer Qualität.
video-reviewer arbeitet auf Storyboard)config.yaml (einmalig, ~30 min)Beim zweiten Projekt nur noch Skills durchlaufen — Setup-Overhead entfällt.