¶ VidCraft - AI Video-Produktion
¶ Inhaltsverzeichnis
- Ueberblick
- Hauptfunktionen
- Workflow Pipeline
- Systemanforderungen
- Installation
- Konfiguration
- Skills
- Video-Typen
- MCP Tools
- Verwendung
- Quality Gates
- Fehlerbehebung
- Technische Details
- FAQ
¶ Ueberblick
VidCraft ist ein Claude Code Plugin fuer die professionelle Erstellung von KI-generierten Videos mit HeyGen und Synthesia. Es fuehrt dich durch den kompletten Produktions-Lifecycle — von der Konzeptentwicklung ueber Script und Storyboard bis zur Veroeffentlichung.
VidCraft automatisiert nicht die Video-Generierung selbst — es optimiert den gesamten Vorbereitungs- und Review-Prozess, damit du hochwertige Videos in einem Bruchteil der Zeit produzierst.
Was VidCraft loest:
- Ohne VidCraft: Unstrukturiertes Script-Schreiben, vergessene Szenen, inkonsistente Qualitaet
- Ohne VidCraft: Manuelles Copy-Paste zwischen Dokumenten und Plattform
- Mit VidCraft: Strukturierter Workflow mit Quality Gates, automatischer Timing-Analyse, plattform-optimierte Formatierung
¶ Hauptfunktionen
- 32 spezialisierte Skills fuer jede Produktionsphase
- 29 MCP Tools fuer State Management, Content, Analyse und Quality Gates
- 12 Video-Typen mit Pacing-Regeln, Struktur-Templates und Best Practices
- Document Analysis — Bestehende Dokumentation (PDF/DOCX/MD) analysieren und in Video-Content umwandeln
- 14-Punkt Script Quality Checklist mit automatischen Pruefungen
- Pre-Generation Gates die blockieren bis alles bereit ist
- Dual Platform Support — HeyGen und Synthesia gleichzeitig
- Multi-Language — Primaer- und Uebersetzungssprachen konfigurierbar
¶ Workflow Pipeline
graph TD
A["Neues Projekt"] --> B{"Doku vorhanden?"}
B -->|Ja| C["Doc Analyzer"]
B -->|Nein| D["Konzept entwickeln"]
C --> D
D --> E["Creative Brief"]
E --> F["Script schreiben"]
F --> G["Script Review 14-Punkt"]
G --> H["Storyboard erstellen"]
H --> I["Screenshots planen"]
I --> J["Assets sammeln"]
J --> K["Pre-Generation Check"]
K --> L{"Plattform?"}
L -->|HeyGen| M["HeyGen Format"]
L -->|Synthesia| N["Synthesia Format"]
M --> O["Generierung manuell"]
N --> O
O --> P["Video Review"]
P --> Q["Veroeffentlichung"]
¶ Typischer Ablauf
/vidcraft:new-project— Projekt mit Verzeichnisstruktur erstellen/vidcraft:doc-analyzer— (Optional) Bestehende Doku analysieren/vidcraft:project-conceptualizer— Konzept und Episoden-Plan entwickeln/vidcraft:brief-creator— Creative Brief erstellen/vidcraft:script-writer— Scripts mit Narration und Visual Cues schreiben/vidcraft:script-reviewer— 14-Punkt Quality Checklist/vidcraft:storyboard-creator— Szene-fuer-Szene Visual Direction/vidcraft:screenshot-planner— Screenshots und Recordings definieren/vidcraft:asset-collector— Assets pruefen und organisieren/vidcraft:pre-generation-check— Quality Gates vor Generierung/vidcraft:heygen-engineeroder/vidcraft:synthesia-engineer— Plattform-Format- Generierung in HeyGen/Synthesia (manuell)
/vidcraft:video-reviewer— 20-Punkt Review/vidcraft:release-director— Veroeffentlichung koordinieren
¶ Systemanforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| Python | 3.10+ | Empfohlen: Python 3.12 |
| Claude Code | 1.0+ | CLI, Desktop oder VS Code Extension |
| pip | 22+ | Fuer venv-Dependencies |
¶ Installation
git clone https://github.com/markus-michalski/vidcraft.git ~/projekte/vidcraft
- Download von GitHub Releases
- Entpacken nach
~/projekte/vidcraft/
¶ Schritt 2: Plugin installieren
claude plugin install ~/projekte/vidcraft
¶ Schritt 3: Setup ausfuehren
In Claude Code:
/vidcraft:setup
Dies erstellt automatisch:
- Python venv unter
~/.vidcraft/venv/ - Dependencies installiert (FastMCP, PyYAML, pdfplumber, python-docx, textstat)
- Config-Template nach
~/.vidcraft/config.yaml - Cache-Verzeichnis
~/.vidcraft/cache/
¶ Schritt 4: Konfiguration anpassen
nano ~/.vidcraft/config.yaml
¶ Schritt 5: Claude neustarten
Claude Code neu starten. Ueberpruefen mit /vidcraft:session-start.
¶ Konfiguration
¶ config.yaml
paths:
content_root: "~/video-projects"
video_root: "~/video-projects/videos"
assets_root: "~/video-projects/assets"
overrides: "~/video-projects/overrides"
defaults:
language: ["de", "en"] # Einzeln oder Liste fuer Multi-Language
wpm: 140 # Words per Minute fuer Timing
platform: "heygen" # Default-Plattform
heygen:
default_avatar: ""
default_voice: ""
synthesia:
default_avatar: ""
default_voice: ""
brand:
name: "Firmenname"
primary_color: "#2563EB"
secondary_color: "#10B981"
tone: ["professional", "friendly"]
¶ Pfade
| Pfad | Beschreibung |
|---|---|
~/.vidcraft/config.yaml |
User-Konfiguration |
~/.vidcraft/cache/state.json |
State Cache (automatisch) |
~/.vidcraft/venv/ |
Python Virtual Environment |
{content_root}/projects/ |
Projekt-Dateien (Markdown) |
{video_root}/projects/ |
Generierte Videos |
{assets_root}/projects/ |
Screenshots, Bilder |
¶ Skills
¶ Core (6 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
new-project |
Sonnet | Projekt mit Verzeichnisstruktur erstellen |
session-start |
Sonnet | Session initialisieren, Setup pruefen |
resume |
Sonnet | Arbeit an Projekt fortsetzen |
next-step |
Sonnet | Status-basierte naechste Aktion empfehlen |
project-dashboard |
Sonnet | Fortschritts-Dashboard anzeigen |
project-conceptualizer |
Opus | 5-Phasen Konzeptentwicklung |
¶ Research (4 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
doc-analyzer |
Opus | PDF/DOCX/MD analysieren, Video-Content extrahieren |
researcher |
Opus | Themen-Recherche mit Web-Zugriff |
audience-researcher |
Opus | Zielgruppen-Analyse und Personas |
research-verifier |
Sonnet | Fakten-Check und Quellen-Validierung |
¶ Writing (4 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
script-writer |
Opus | Scripts mit Narration und Visual Cues |
script-reviewer |
Sonnet | 14-Punkt Quality Checklist |
brief-creator |
Opus | Creative Brief aus Requirements |
voice-checker |
Sonnet | AI-Sprache erkennen, Authentizitaet pruefen |
¶ Visual (4 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
storyboard-creator |
Opus | Szene-fuer-Szene Storyboard |
shot-list-creator |
Sonnet | Produktionsreife Shot-Liste |
screenshot-planner |
Sonnet | Screenshot-Positionen definieren |
asset-collector |
Sonnet | Assets pruefen und organisieren |
¶ Production (4 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
heygen-engineer |
Sonnet | HeyGen-optimiertes Format |
synthesia-engineer |
Sonnet | Synthesia-optimiertes Format |
avatar-selector |
Sonnet | Avatar-Empfehlung nach Zielgruppe |
pre-generation-check |
Sonnet | Quality Gates vor Generierung |
¶ Review (5 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
video-reviewer |
Opus | 20-Punkt Post-Generation Review |
brand-checker |
Sonnet | Marken-Konsistenz pruefen |
accessibility-checker |
Sonnet | Barrierefreiheit (WCAG 2.1) |
voice-checker |
Sonnet | AI-Sprache erkennen |
timing-validator |
Haiku | Schneller Timing-Check |
¶ Distribution (3 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
release-director |
Sonnet | Veroeffentlichung koordinieren |
promo-writer |
Opus | Social-Media-Texte schreiben |
thumbnail-director |
Sonnet | Thumbnail-Konzepte erstellen |
¶ Utility (4 Skills)
| Skill | Model | Beschreibung |
|---|---|---|
video-type-creator |
Opus | Neue Video-Typen erstellen |
help |
Haiku | Verfuegbare Skills anzeigen |
configure |
Sonnet | Config interaktiv einrichten |
setup |
Sonnet | Ersteinrichtung |
¶ Video-Typen
| Typ | Dauer | Pacing | Einsatz |
|---|---|---|---|
| tutorial | 3-15 min | Langsam, Schritt-fuer-Schritt | Software-Anleitungen |
| installation-guide | 2-8 min | Klar, sequenziell | Plugin-/Software-Installation |
| product-demo | 2-5 min | Mittel, dynamisch | Produktvorstellung |
| explainer | 60-120s | Mittel bis schnell | Konzepte erklaeren |
| training | 5-20 min | Strukturiert | Schulungen |
| onboarding | 3-10 min | Freundlich, klar | Neue Nutzer/Mitarbeiter |
| marketing-spot | 15-60s | Schnell, emotional | Werbung (AIDA) |
| faq-video | 30-90s | Direkt | Support-Entlastung |
| testimonial | 60-120s | Authentisch | Social Proof |
| how-to | 2-8 min | Praktisch | Praxis-Anleitungen |
| webinar-teaser | 30-60s | Energetisch | Event-Promotion |
| social-short | 15-60s | Sehr schnell | TikTok/Reels/Shorts |
Jeder Typ hat ein README.md mit Struktur-Template, Pacing-Regeln, Script-Konventionen, Visual Direction und Beispiel-Storyboard.
Neue Video-Typen koennen jederzeit mit
/vidcraft:video-type-creatorerstellt werden.
¶ MCP Tools
¶ State Management (8 Tools)
| Tool | Beschreibung |
|---|---|
list_projects |
Alle Projekte mit Status auflisten |
find_project |
Projekt per Slug oder Name finden |
get_project_full |
Komplettes Projekt mit allen Episoden und Szenen |
get_project_progress |
Fortschritt in Prozent pro Phase |
rebuild_state |
State Cache aus Markdown neu aufbauen |
get_session |
Aktuelle Session (letztes Projekt, Phase) |
update_session |
Session-Kontext aktualisieren |
search |
Volltextsuche ueber alle Projekte |
¶ Content Operations (7 Tools)
| Tool | Beschreibung |
|---|---|
create_project_structure |
Neues Projekt mit Templates |
create_episode |
Episode in Projekt erstellen |
create_scene |
Szene in Episode erstellen |
update_field |
YAML-Frontmatter-Feld aktualisieren |
resolve_path |
Dateisystem-Pfad aufloesen |
extract_section |
Markdown-Sektion extrahieren |
format_for_clipboard |
Script fuer Copy-Paste formatieren |
¶ Document Analysis (5 Tools)
| Tool | Beschreibung |
|---|---|
analyze_document |
PDF/DOCX/MD parsen und strukturieren |
extract_key_points |
Kernaussagen fuer Video identifizieren |
suggest_video_structure |
Szenen-Struktur aus Doku ableiten |
analyze_complexity |
Komplexitaet bewerten, Typ empfehlen |
suggest_video_topics |
Video-Themen aus Doku vorschlagen |
¶ Platform Integration (5 Tools)
| Tool | Beschreibung |
|---|---|
validate_platform_limits |
Zeichen-/Szenen-Limits pruefen |
get_platform_capabilities |
Plattform-Features abfragen |
heygen_format_script |
Fuer HeyGen formatieren |
synthesia_format_script |
Fuer Synthesia formatieren |
list_required_assets |
Fehlende Assets identifizieren |
¶ Script Analysis (2 Tools)
| Tool | Beschreibung |
|---|---|
analyze_timing |
WPM-Berechnung, Dauer-Schaetzung |
check_readability |
Flesch-Score, Satzlaenge |
¶ Quality Gates (2 Tools)
| Tool | Beschreibung |
|---|---|
run_pre_generation_gates |
Alle Gates vor Generierung |
validate_project_structure |
Verzeichnis-Integritaet pruefen |
¶ Verwendung
¶ Schnellstart
/vidcraft:new-project "OXID Gallery Tutorial" tutorial
Claude erstellt die Projektstruktur und fragt nach Episoden.
1. /vidcraft:new-project "OXID Gallery Tutorial" tutorial
2. /vidcraft:doc-analyzer ~/docs/gallery-readme.md
3. /vidcraft:script-writer oxid-gallery-tutorial 01-installation
4. /vidcraft:script-reviewer oxid-gallery-tutorial 01-installation
5. /vidcraft:storyboard-creator oxid-gallery-tutorial 01-installation
6. /vidcraft:pre-generation-check oxid-gallery-tutorial 01-installation
7. /vidcraft:heygen-engineer oxid-gallery-tutorial 01-installation
1. /vidcraft:doc-analyzer ~/docs/existing-manual.pdf
→ Analyse: 3500 Woerter, 12 Sektionen, empfohlen: Tutorial-Serie (3 Episoden)
2. /vidcraft:new-project "Produkt Handbuch" tutorial
3. /vidcraft:brief-creator produkt-handbuch
4. /vidcraft:script-writer produkt-handbuch 01-einfuehrung
1. /vidcraft:new-project "Was ist ALTCHA?" explainer
2. /vidcraft:script-writer was-ist-altcha 01-erklaerung
3. /vidcraft:synthesia-engineer was-ist-altcha 01-erklaerung
¶ Quality Gates
¶ Pre-Generation Gates
| # | Gate | Typ | Beschreibung |
|---|---|---|---|
| 1 | Script Status | BLOCK | Script muss reviewed sein |
| 2 | Szenen vorhanden | BLOCK | Mindestens eine Szene mit Narration |
| 3 | Narration komplett | BLOCK | Alle Szenen muessen Narration haben |
| 4 | Visual Direction | WARN | Alle Szenen sollten Visual Direction haben |
| 5 | Timing | INFO | Geschaetzte Dauer anzeigen |
¶ Script Quality Checklist (14 Punkte)
- Timing (WPM vs. Ziel-Dauer)
- Readability (Flesch-Score >= 60)
- Struktur (Typ-konforme Szenen-Abfolge)
- Hook-Qualitaet (erste 5 Sekunden)
- CTA vorhanden und klar
- Konsistente Tonalitaet
- Keine AI-Sprache
- Satzlaenge (max. 20 Woerter)
- Szenen-Dauer (keine > 60s)
- Uebergaenge definiert
- Visual Cues vorhanden
- On-Screen Text <= 7 Woerter
- Kein Jargon ohne Erklaerung
- Zusammenfassung (bei Tutorials)
¶ Fehlerbehebung
¶ Problem: MCP Server verbindet nicht
Symptome: Skills zeigen Fehler, keine MCP Tools verfuegbar
Pruefen:
- Plugin installiert?
claude plugin list - venv existiert?
ls ~/.vidcraft/venv/bin/python3 - Dependencies installiert?
~/.vidcraft/venv/bin/pip list | grep mcp
Loesung:
/vidcraft:setup
¶ Problem: State Cache leer
Symptome: list_projects zeigt nichts, obwohl Projekte existieren
Loesung:
/vidcraft:session-start
Dies rebuilt den State Cache automatisch.
¶ Problem: Document Analysis schlaegt fehl
Symptome: analyze_document gibt Import-Fehler
Loesung:
~/.vidcraft/venv/bin/pip install pdfplumber python-docx
¶ Technische Details
¶ Architektur
graph TD
A["Claude Code"] -->|stdio| B["FastMCP Server"]
B --> C["StateCache"]
C --> D["state.json"]
B --> E["Indexer"]
E --> F["Markdown Parsers"]
F --> G["Projekt-Dateien"]
B --> H["Document Parser"]
H --> I["PDF / DOCX / MD"]
B --> J["Script Analyzer"]
¶ Projektstruktur
vidcraft/
├── .claude-plugin/ # Plugin-Manifest
├── servers/vidcraft-server/ # FastMCP Server (Python)
├── tools/ # Backend-Module
│ ├── shared/ # Config, Paths
│ ├── state/ # Indexer, Parsers
│ └── analysis/ # Document Parser
├── skills/ # 32 SKILL.md Dateien
├── templates/ # 7 Markdown-Templates
├── video-types/ # 12 Typ-Definitionen
├── reference/ # Wissensdatenbank
├── hooks/ # PostToolUse Validation
└── tests/ # 138 Tests (pytest)
¶ Status-Progressionen
Projekt:
Concept → Brief Complete → Research Done → Script Draft → Script Approved
→ Storyboard Done → Assets Ready → Generated → Reviewed → Published
Episode:
Not Started → Script Draft → Script Reviewed → Storyboard
→ Assets Collected → Ready for Generation → Generated → QA Passed → Final
Szene:
Outline → Script Written → Visual Defined → Assets Ready → Generated → Approved
¶ FAQ
F: Generiert VidCraft die Videos automatisch?
A: Nein. VidCraft optimiert den Vorbereitungsprozess (Script, Storyboard, Formatting). Die eigentliche Video-Generierung erfolgt manuell in HeyGen oder Synthesia. Zukuenftige Versionen koennten API-Integration bieten.
F: Kann ich beide Plattformen gleichzeitig nutzen?
A: Ja. Jede Episode kann eine eigene Plattform haben. Die kreative Arbeit ist plattform-unabhaengig.
F: Welche Dokumentformate werden unterstuetzt?
A: PDF, DOCX und Markdown. Der Doc Analyzer extrahiert Struktur, Code-Bloecke, Listen und Ueberschriften.
F: Kann ich eigene Video-Typen erstellen?
A: Ja. Mit /vidcraft:video-type-creator [name] erstellst du neue Typ-Definitionen mit Pacing-Regeln, Struktur-Template und Best Practices.
F: Brauche ich einen HeyGen/Synthesia Account?
A: Ja, fuer die Generierung. VidCraft selbst ist kostenlos und Open Source.
¶ Lizenz
MIT License — GitHub Repository
Entwickelt von Markus Michalski