mason0510/video-frame-analysis-skills

video-frame-analysis

Überblick

„Lokales Video → ffprobe → zeitgestempelte Frame-Extraktion → Kontaktbogen → OCR → summary.txt / ocr.json ausgeben“ als wiederverwendbares, leichtgewichtiges Skill festgehalten.

Geeignet für Agenten wie Codex, Claude Code, OpenCode zur Verarbeitung lokaler Demo-Videos, Bildschirmaufnahmen oder Walkthroughs von Konkurrenzseiten.

Wann verwenden

Geeignet für:

• Ein Benutzer gibt ein lokales Video und möchte wissen, wie weit ein Produkt entwickelt ist
• Das Video soll in überprüfbare Einzelbilder, OCR-Text und Zusammenfassungsdateien zerlegt werden
• Zunächst eine leichte Beweissicherung, dann manuelle Beurteilung oder weitere Analyse
• Vermeidung von manuellem Zusammensetzen von ffmpeg- / tesseract-Befehlen

Nicht geeignet für:

• Herunterladen von Online-Videos
• Stapelverarbeitung mehrerer Videos
• Echtzeit-Streaming-Analyse
• GUI- oder Web-Plattformen
• Schwere Video-Verständnismodelle

Schnellstart

bash scripts/video-frame-analysis.sh /pfad/zum/demo.mp4 ./ausgabe/demo-analyse

Standardausgabe:

• ffprobe.txt
• frame_*.jpg
• contact.png
• ocr.txt
• ocr.json
• summary.txt

Installation

Empfohlen: Direkt in Codex / Claude Code / OpenCode installieren:

npx skills add https://github.com/mason0510/video-frame-analysis-skills -g --all

Nach der Installation die Agent-Sitzung neu starten, dann das Skill nach Bedarf auslösen.

Eingabe / Ausgabe

Eingabe

• Lokaler Videopfad
• Ausgabeverzeichnispfad

Ausgabe

• Video-Metadaten
• Zeitgestempelte Einzelbilder
• Kontaktbogen
• OCR-Text
• OCR-JSON
• Zusammenfassungstext

Konfiguration

FRAME_INTERVAL_SECONDS=5 FRAME_WIDTH=420 OCR_LANG=deu \
  bash scripts/video-frame-analysis.sh ./demo.mp4 ./ausgabe/demo

Variable	Beschreibung	Standardwert
FRAME_INTERVAL_SECONDS	Abstand zwischen Frames (Sekunden)	8
FRAME_WIDTH	Breite eines Einzelbildes	360
OCR_LANG	OCR-Sprache(n)	chi_sim+eng

Projektdateien

• scripts/video-frame-analysis.sh: Hauptskript
• tests/test_video_frame_analysis.sh: Minimaler End-to-End-Test
• references/output-format.md: Beschreibung des Ausgabeverzeichnisses
• agents/openai.yaml: Anzeigeinformationen für OpenAI/Codex

Häufige Fehler

• Als schweres Video-Verständnismodell missverstehen
• Zu dichte Frame-Extraktion, die OCR-Rauschen erhöht
• Kontaktbogen ignorieren und nur OCR-Text betrachten
• Nicht prüfen, ob ffmpeg / tesseract installiert sind