Mit /vidcraft:doc-analyzer <dateipfad> [video-typ] machst du aus vorhandener Dokumentation einen Produktionsplan: Struktur, Schlüsselpunkte, geeigneter Video-Typ und grobe Szenenliste. Die Analyse läuft lokal im MCP-Server.
Die Datei muss unter deinem
content_rootliegen. Alle Analyse-Tools lehnen Pfade außerhalb dieses Verzeichnisses ab. Kopiere die Quelle gegebenenfalls nach{content_root}/projects/<projekt>/research/.
| Format | Parser | Erkannt werden |
|---|---|---|
Markdown (.md) |
eingebaut | Überschriften, Code-Blöcke, Listen, Frontmatter |
PDF (.pdf) |
pdfplumber |
Text, Seitenstruktur, Metadaten |
Word (.docx) |
python-docx |
Überschriften, Formatvorlagen, Listen, eingebettete Bilder |
Bilder werden nur im Word-Parser erkannt. Bei Markdown und PDF liefert die Analyse daher nie das Merkmal "Bilder".
Andere Endungen außer .doc werden mit einer Fehlermeldung abgelehnt. .doc wird zwar angenommen und an den python-docx-Parser weitergereicht, eine echte alte .doc-Datei löst dort aber einen python-docx-Fehler aus, der nicht abgefangen wird. Konvertiere solche Dateien vorher nach .docx.
Der Skill führt diese Tools der Reihe nach aus. Die Tools 3 bis 5 laufen parallel, sobald 1 und 2 vorliegen.
| Tool | Ergebnis |
|---|---|
analyze_document |
Titel, Format, Wortzahl, Abschnitte mit Überschrift, Ebene, Wortzahl und Merkmalen (Code, Liste, Bilder; Bilder nur bei DOCX) |
analyze_complexity |
Komplexitäts-Score von 0 bis 100, empfohlener Typ mit Begründung, empfohlene Episodenzahl |
extract_key_points |
Bis zu max_points (Standard 10) Schlüsselpunkte mit Relevanz und Hinweis auf Szenen-Art |
suggest_video_structure |
Szenenliste mit Bildtyp, geschätzten Wörtern und Dauer, bei 140 WPM gerechnet |
suggest_video_topics |
Bis zu max_topics (Standard 5) mögliche Videos mit Titel, Typ, Dauer und Quell-Abschnitten |
Typ-Empfehlung (analyze_complexity), in dieser Reihenfolge:
| Bedingung | Empfohlener Typ |
|---|---|
| mehr als die Hälfte der Abschnitte enthält Code | tutorial |
| mehr als die Hälfte der Abschnitte enthält Listen | installation-guide |
| unter 500 Wörter | explainer |
| über 2000 Wörter | training |
| sonst | product-demo |
Episodenzahl: unter 2000 Wörter eine Episode, bis 5000 Wörter mindestens zwei (ein Drittel der Abschnitte), darüber mindestens drei (die Hälfte der Abschnitte).
Szenen (suggest_video_structure): Es entsteht immer eine Einleitung vorne und eine Zusammenfassung hinten. Abschnitte unter 20 Wörtern werden übergangen. Abschnitte mit Code werden screencast, mit Bildern split (nur DOCX), mit Listen slides, alle anderen avatar. Der übergebene Video-Typ wird im Ergebnis genannt, ändert die Szenenaufteilung aber nicht.
Schlüsselpunkte: Jeder Abschnitt mit Überschrift ergibt einen Punkt. Code und Listen werden als code_demo beziehungsweise steps markiert, Abschnitte mit Bildern als visual (nur DOCX).
Das sind einfache Zählregeln. Sie liefern einen Ausgangspunkt, keine fertige Planung.
Der Skill fasst alles in einem Bericht zusammen: Quelle, Komplexität, Schlüsselpunkte, Szenenstruktur mit Zeiten, benötigte Assets (Screenshots, Aufnahmen) und nächste Schritte. Auf Wunsch legt er mit create_project_structure ein Projekt an oder speichert Themen mit create_video_idea in IDEAS.md.
Bei Dokumenten über 5000 Wörtern empfiehlt der Skill, mehrere Episoden zu planen.