This example walks through the complete VidCraft workflow with a real use case: an OXID Gallery plugin exists with README documentation, and we produce a 3-part tutorial series for YouTube from it.
Starting point:
mmd_gallery (fictitious, but realistic per OXID convention)~/projekte/oxid-gallery/README.md (3,520 words, 12 sections)Output at the end:
/vidcraft:doc-analyzer ~/projekte/oxid-gallery/README.md tutorial
Output (truncated):
Document Analysis: oxid-gallery README.md
Stats: 3,520 words, 12 sections, 18 code blocks
Recommendation:
- Video type: tutorial series (3 episodes)
- Ep 01: Installation
- Ep 02: Configuration
- Ep 03: Theming + Troubleshooting
- Estimated duration: 8-12 min total
- Audience: mid-level shop admin
Key points:
1. [HIGH] OXID Gallery requires PHP 8.1 + OXID 7.0
2. [HIGH] Composer install does not auto-activate
3. [MID] Theme override via bin/oe-console
4. [MID] Fancybox 5 (LGPL) as lightbox lib
/vidcraft:new-project "OXID Gallery Tutorial" tutorial
Output:
Project created: oxid-gallery-tutorial
Path: ~/video-projects/projects/oxid-gallery-tutorial/
Status: Concept
/vidcraft:audience-researcher oxid-gallery-tutorial
Output (truncated):
# Audience: oxid-gallery-tutorial
## Persona 1: "Maria, OXID Shop Admin"
- 35, junior developer at a mid-market e-commerce
- Experience: 2 years OXID, knows Composer
- Pain: plugin installation often hits theme conflicts
- Knowledge level: mid (understands "Composer", "module activation")
- Motivation: get plugin live fast, no bugs
## Persona 2: "Tom, Senior Dev"
- 42, technical lead at agency
- Experience: 8 years OXID, knows OXID 4 + 6 + 7
- Pain: plugin docs often outdated, conflicts on updates
- Knowledge level: high (understands "container cache", "DI", "Twig override")
- Motivation: clean code, clear architecture decisions
/vidcraft:project-conceptualizer oxid-gallery-tutorial
Output (truncated):
# Concept: OXID Gallery Tutorial
## Goal
Walk shop admins through the complete OXID Gallery installation
and configuration with focus on the most common failure modes.
## Tonality
- Factual, not condescending
- Patient — even mid-level admins make Composer mistakes
- Direct, no marketing speak
## Episode bracket
Ep 01: Installation (setup + activation)
Ep 02: Configuration (settings + lightbox)
Ep 03: Theming + Troubleshooting (customizing + fixes)
## Visual identity
- Brand colors: #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
- Reduce plugin-installation support tickets by 50%
- 1,000 views per episode in 30 days
- 5+ "this helped!" comments per episode
## Audience
- Primary: OXID shop admins (Maria persona)
- Secondary: senior devs (Tom persona)
## Tone & Style
- Factual, patient, direct
- No memes, no hype
- Code in foreground, avatar as accompaniment
## Constraints
- HeyGen, max 1,500 characters per scene
- Episodes max 5 min (YouTube algorithm)
- DE-first, EN subtitles
## Key Messages
1. Install plugin correctly (Composer + activation)
2. Configuration is defensive (defaults are safe)
3. For theme conflicts: apply known fixes
/vidcraft:script-writer oxid-gallery-tutorial 01-installation
Output (excerpt):
---
episode_id: 01-installation
title: "Install OXID Gallery"
status: Script Draft
target_duration: "3-4 min"
target_wpm: 130
target_words: 390-520
---
# Episode 01: Install OXID Gallery
## Scene 01 — Hook (5s, ~12 words)
**Narration:**
OXID Gallery installs in eight minutes — if you have the right
dependencies. Here they are.
**Visual:** [zoom] OXID Gallery logo, then [highlight] PHP version
## Scene 02 — Prerequisites (25s, ~55 words)
**Narration:**
You need PHP 8.1 or higher, OXID 7.0 or newer, and Composer 2.5+.
If you don't have one of those — pause the video, install it,
and come back. I'll wait.
[pause 0.5s]
**Visual:** [screencast] Terminal: `php --version`, then `composer --version`
## Scene 03 — Composer Install (60s, ~130 words)
**Narration:**
First step: composer require mmd/gallery in your OXID root.
[pause 0.3s]
Composer downloads the plugin to vendor/mmd/gallery.
But that does NOT activate it — and that's the most common
trap.
[pause 0.5s]
To activate it, run `bin/oe-console oe:module:activate mmd_gallery`.
That registers the plugin in the OXID container and activates the
default templates.
**Visual:** [screencast] Terminal with both commands, then
[highlight] success output "Module activated successfully"
## Scene 04 — Verification (20s, ~45 words)
**Narration:**
Verification: head to the OXID admin → Extensions → Modules.
mmd_gallery should show up as "active".
If not: clear the container cache with `bin/oe-console oe:cache:clear`.
**Visual:** [screencast] OXID admin "Modules" list, [highlight] mmd_gallery
## Scene 05 — Outro/CTA (15s, ~35 words)
**Narration:**
Plugin is installed. In the next video we configure the default
gallery and set up the lightbox.
[pause 0.3s]
See you soon.
**Visual:** [outro-frame] with brand logo + "Episode 02 next"
Word count: 277 (target: 390-520) — slightly under, comes up in review.
/vidcraft:script-reviewer oxid-gallery-tutorial 01-installation
Output:
## Script Review: Episode 01
### 14-Point Quality Check
- [x] 1. Timing — 277 words / 130 WPM = 2:08
⚠️ Below target (3-4 min) → Extend verification scene
with common Composer errors
- [x] 2. Readability — Flesch 67 ✓
- [x] 3. Structure — Hook → Prereqs → Steps → Verification → CTA ✓
- [x] 4. Hook — "OXID Gallery installs in 8 min — if..."
✓ Concrete, no "In this tutorial..."
- [x] 5. CTA — "In the next video..." single, clear ✓
- [x] 6. Tone — factual, patient ✓
- [x] 7. AI language — no findings ✓
- [x] 8. Sentence length — median 13, max 18 ✓
- [x] 9. Scene duration — longest 60s (Scene 03) ✓
- [x] 10. Transitions — fade defined ✓
- [x] 11. Visual cues — every scene has [zoom]/[screencast]/[highlight] ✓
- [x] 12. On-screen text — max 5 words ✓
- [x] 13. Jargon — "container cache" once without explanation
→ Suggestion: "container cache (OXID's internal resolution cache)"
- [WARN] 14. Summary — missing before CTA
→ Recommendation: insert 10s "summary of steps"
## Overall: 12 / 14 — Revise before Generation
Critical: none
Polish: 1 (words), 13 (jargon), 14 (summary)
User extends script by 70 words, adds summary, glosses "container cache". Re-run of script-reviewer shows 14/14.
/vidcraft:voice-checker oxid-gallery-tutorial 01-installation
Output:
Voice Check: 1 advisory finding
L. 89: "the most common trap"
→ Borderline cliché (idiomatic okay, but interchangeable in tech context)
→ Suggestion: "the typical mistake here" or stay concrete
User decides: "trap" works in tech context, stays. (Voice checker is advisory.)
/vidcraft:storyboard-creator oxid-gallery-tutorial 01-installation
Output (excerpt):
# Storyboard: Episode 01
## Scene 01 — Hook
- **Visual:** Brand logo animation (1.5s) → code-stream background with "PHP 8.1+, OXID 7.0+, Composer 2.5+" as on-screen text
- **Avatar:** Anna_Professional, position center, speed 1.0
- **Background:** Dark code wallpaper (#0F172A, code particles)
- **Transition to Scene 02:** Cut
## Scene 02 — Prerequisites
- **Visual:** Split screen: avatar left, terminal right (live-typing animation)
- **Background:** Office (light), terminal full screen right
- **Avatar position:** left
- **Transition:** Match-cut (terminal content to Composer output)
## Scene 03 — Composer Install
- **Visual:** Full-screen terminal recording (pre-recorded),
avatar as picture-in-picture top right (small)
- **Background:** Terminal screen recording
- **On-screen text:** "composer require mmd/gallery" centered (3s)
- **Transition:** Whip-cut to admin UI
[... Scene 04, 05 analogous]
/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 list
## 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 records screen recordings (OBS), screenshots OXID admin, and places them under 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 scenes present
✅ Gate 3: Narration complete
✅ Gate 4: Visual direction in all scenes
ℹ️ Gate 5: Estimated duration 3:12 (target: 3-15 min)
✅ HeyGen Validation:
All scenes under 1,500 characters ✓
Avatar consistency ✓
Background count okay ✓
🟢 PASSED — Ready for HeyGen
/vidcraft:heygen-engineer oxid-gallery-tutorial 01-installation
Output (heygen-format.md, excerpt):
# HeyGen Format: Episode 01
## Scene 01 — Hook
- Avatar: Anna_Professional_Front
- Voice: en-US-JennyNeural
- Speed: 1.0
- Background: dark-code-wallpaper.jpg
- Avatar Position: center
- Script: |
OXID Gallery installs in eight minutes — if you have the
right dependencies. Here they are.
## Scene 02 — Prerequisites
- Avatar: Anna_Professional_Front
- Voice: en-US-JennyNeural
- Speed: 1.0
- Background: office-light.jpg
- Avatar Position: left
- Script: |
You need PHP 8.1 or higher, OXID 7.0 or newer, and
Composer 2.5+.
[pause 0.5s]
If you don't have one of those — pause the video, install it,
and come back. I'll wait.
[... Scenes 03-05]
User pastes that into HeyGen, uploads brand assets, activates avatar/voice, and clicks Generate.
After 8 minutes of generation, the user downloads the video to 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 too bright — avatar/background contrast is flat
### Narration (4/4) ✓
### Brand (4/4) ✓
### Accessibility (4/4) ✓
## Overall: 19 / 20 — Approved with minor revision
Required: darken background Scene 02 (re-render with office-medium.jpg)
User re-renders Scene 02 in HeyGen with a darker background, merges into the final file (or re-renders fully — usually faster than editing in HeyGen).
/vidcraft:subtitle-generator oxid-gallery-tutorial 01-installation
Output:
Whisper transcription running...
✅ output/episodes/01-installation/subtitles-de.srt (3,520 chars)
Translation running (DE → EN)...
✅ output/episodes/01-installation/subtitles-en.srt (3,180 chars)
YouTube-ready: max 21 chars/sec respected ✓
/vidcraft:promo-writer oxid-gallery-tutorial 01-installation
Output (excerpt):
# Promo: Episode 01
## YouTube Description
**OXID Gallery Plugin — Episode 01: Installation**
In this episode you install the OXID Gallery plugin in under
8 minutes. Step by step:
✅ Verify prerequisites (PHP 8.1, OXID 7.0, Composer 2.5+)
✅ Run Composer install
✅ Activate module with oe-console
✅ Verify in OXID admin
✅ Common container-cache fix
📺 Episode 02: Configuration → [Link]
📺 Episode 03: Theming → [Link]
🔗 Plugin repository: github.com/markus-michalski/oxid-gallery
🔗 OXID docs: https://docs.oxid-esales.com
#OXID #eCommerce #Tutorial #PHP
## Facebook
🚀 New OXID tutorial is live!
Install OXID Gallery — in under 8 minutes.
No frustration, no hiccups, with a quick container-cache fix.
[Link to YouTube]
## Instagram
[Caption for reel cut of the hook]
Install OXID Gallery — 8 min, no stress.
Full tutorial link in bio. ⬇️
#oxid #ecommerce #devlife
## X (Twitter)
Install OXID Gallery in 8 min.
Prereqs ✓
Composer install ✓
Activation (most common fail!) ✓
Verification + cache fix ✓
Tutorial: [link]
## LinkedIn
[B2B variant with longer context + audience targeting]
/vidcraft:thumbnail-director oxid-gallery-tutorial 01-installation
Output (concept):
# Thumbnail Concepts: Episode 01
## Concept A (recommended)
- Layout: 16:9
- Background: dark code wallpaper (#0F172A)
- Foreground: OXID logo left, "GALLERY" right in brand blue (#2563EB)
- Top banner: "EPISODE 01"
- Main element: "INSTALL IN 8 MIN" — bold, white
- Anna avatar as small cutout bottom right
## Concept B (alternative)
- Layout: 16:9
- Background: hand-on-keyboard photo (stock)
- Overlay: gradient brand blue
- Main element: "OXID GALLERY" — bold white
- Sub-element: "Setup Guide ✅"
## Recommendation
Concept A — keeps Markus-Michalski-tutorial branding clear
and visually surfaces the episode number.
/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 finalized (Concept A)
- [x] Promo copy approved
## Distribution
| Channel | Status | Date |
|---------|--------|------|
| YouTube | scheduled 2026-04-26 09:00 | unlisted until schedule |
| LinkedIn | manual post 2026-04-26 10:00 | — |
| FB Page | manual post 2026-04-26 10:30 | — |
| IG (reel cut) | 2026-04-27 (separate cut) | TODO |
| X (thread) | manual post 2026-04-26 11:00 | — |
## Metadata
- Title: "Install OXID Gallery — Tutorial Episode 01"
- Description: from 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 at 2:30, plugin repo at 0:45
- Thumbnail: Concept A
## Status: Ready to publish
User uploads to YouTube, schedules 2026-04-26 09:00 UTC. Episode 01 done.
Episodes 02 (Configuration) and 03 (Theming + Troubleshooting) follow the same pattern — just repeat steps 6-19.
Tip: for multi-episode projects the
brand-checkerbetween episodes is worth running to catch tone drift early.
/vidcraft:brand-checker oxid-gallery-tutorial 02-configuration
Findings typically cover: lower-third consistency, tone drift, glossary compliance ("OXID eShop" vs. "OXID Shop").
| Phase | Skills | Estimated | Real (Markus, experienced user) |
|---|---|---|---|
| Doc analysis + concept | 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 |
| Episodes 02 + 03 | each like 01 | 2.5h each | 90 min each |
| Total | ~10h | ~5h |
Comparison without VidCraft (from experience): pure ChatGPT + manual workflow for 3 episodes = ~15-20h, with unsystematic quality.
video-reviewer operates on storyboard)config.yaml (one-time, ~30 min)On the second project you only run skills — setup overhead is gone.