Communitygithub.com

Video Clip Assistant

Automatischer Video-Clip-Assistent. Extrahiert Highlights, erstellt Untertitel, schneidet Videos und produziert Kurzvideos mit FFmpeg – bereit für den Export auf mehrere Plattformen.

Was ist Video Clip Assistant?

Der **Video Clip Assistant** ist ein leistungsstarkes CLI-Tool zur automatischen Videobearbeitung, das auf FFmpeg aufbaut. Es ermöglicht Entwicklern und Content-Erstellern, Highlights aus langen Videos zu extrahieren, Untertitel zu generieren und einzubrennen, Videos zeitbasiert zu schneiden und Kurzvideos in verschiedenen Seitenverhältnissen (9:16, 1:1, 16:9) zu exportieren. Das Skill enthält mehrere Python-Skripte: `cut_video.py` für Zeitschnitte, `burn_subtitles.py` für die Untertiteleinbettung, `export_social.py` für soziale Plattformen, `extract_highlights.py` zur automatischen Highlight-Erkennung und `generate_subtitles.py` zur ASR-basierten Untertitelgenerierung (unterstützt Whisper und FunClip). Besonders nützlich ist der Assistent für Workflows wie das Extrahieren von Schlüsselszenen aus Besprechungsaufzeichnungen, das Erstellen von beschrifteten Videos für Bildungsinhalte oder die Massenproduktion von Kurzvideos für TikTok, Instagram und YouTube. Der Assistent setzt FFmpeg voraus und kann optional mit Whisper oder dem Alibaba FunClip-ASR-Dienst erweitert werden. Er ist plattformunabhängig und eignet sich perfekt für alle, die manuelle Videobearbeitung automatisieren möchten.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/AragornZJF/skill-tools/tree/HEAD/skills/video-processing/video-clip-assistant

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Video Clip Assistant?

Automatischer Video-Clip-Assistent. Basiert auf FFmpeg und bietet Videoclipping, Untertitelgenerierung, Kurzvideoexport und mehr.

Kernfunktionen

  1. Zeitleistenschnitt — Clips nach Zeitstempel extrahieren
  2. Stichwortschnitt — Auf ASR-Untertiteln basierend die zu Schlüsselwörtern passenden Clips finden
  3. Untertitel einbrennen — SRT-Untertitel in das Video einbetten
  4. Kurzvideoexport — Für Formate 9:16 / 1:1 / 16:9 zuschneiden
  5. Highlights extrahieren — Automatisch Highlights aus langen Videos extrahieren

Schnellstart

Nach Zeit schneiden

python3 scripts/cut_video.py --input video.mp4 --start 10 --duration 30 --output clip.mp4

Mehrere Abschnitte extrahieren

python3 scripts/cut_video.py --input video.mp4 --segments "0-30,60-90,120-150" --output ./clips/

Untertitel einbrennen

python3 scripts/burn_subtitles.py --input video.mp4 --srt subs.srt --output subtitled.mp4

Kurzvideo exportieren

python3 scripts/export_social.py --input video.mp4 --format vertical --duration 60 --output shorts/

Skriptbeschreibungen

scripts/cut_video.py

Schneidet Video nach Zeitleiste.

python3 scripts/cut_video.py \
  --input <Videodatei> \
  --start <Sekunden> \
  --duration <Sekunden> \
  [--segments "0-30,60-90"] \
  --output <Ausgabe>

scripts/burn_subtitles.py

Brennt SRT-Untertitel in das Video ein.

python3 scripts/burn_subtitles.py \
  --input <Video> \
  --srt <Untertiteldatei> \
  --output <Ausgabe>

Unterstützt benutzerdefinierte Untertitelposition, Schriftgröße und Farbe.

scripts/export_social.py

Exportiert in mehrplattform-kompatible Formate.

python3 scripts/export_social.py \
  --input <Video> \
  --format <vertical|square|horizontal> \
  --duration <Sekunden> \
  --output <Ausgabeverzeichnis>
FormatSeitenverhältnisVerwendung
vertical9:16TikTok / Kuaishou / Xiaohongshu
square1:1Instagram
horizontal16:9YouTube / Bilibili

scripts/extract_highlights.py

Extrahiert automatisch Highlights aus langen Videos.

python3 scripts/extract_highlights.py \
  --input <Video> \
  --num-clips <Anzahl der Clips> \
  --min-duration <Mindestsekunden> \
  --output <Ausgabeverzeichnis>

Verwendet Szenenerkennungsalgorithmen, um interessante Schnittpunkte zu finden.

scripts/generate_subtitles.py

Generiert SRT-Untertiteldateien (ASR-Dienst erforderlich).

python3 scripts/generate_subtitles.py \
  --input <Video> \
  --provider <whisper|funclip> \
  --output <Untertitel.srt>

Typische Workflows

Workflow 1: 3 Highlights aus Meeting-Aufnahme extrahieren

# 1. 3 Clips schneiden
python3 scripts/cut_video.py \
  --input meeting.mp4 \
  --segments "300-360,720-780,1200-1260" \
  --output ./clips/

# 2. Jeweils als TikTok-Format exportieren
for f in ./clips/*.mp4; do
  python3 scripts/export_social.py \
    --input "$f" \
    --format vertical \
    --output ./shorts/
done

Workflow 2: Video mit Untertiteln versehen

# 1. Untertitel generieren
python3 scripts/generate_subtitles.py \
  --input video.mp4 \
  --provider whisper \
  --output video.srt

# 2. Untertitel einbrennen
python3 scripts/burn_subtitles.py \
  --input video.mp4 \
  --srt video.srt \
  --output subtitled.mp4

Workflow 3: Mehrere Kurzvideos auf einmal erstellen

python3 scripts/export_social.py \
  --input long_video.mp4 \
  --format vertical \
  --duration 60 \
  --output ./shorts/

Systemvoraussetzungen

  • Erforderlich : FFmpeg (ffmpeg / ffprobe)
  • Optional : FunClip (Alibaba Open-Source-ASR-Videoeditor)
  • Optional : Whisper (lokal oder als API)

Installationshinweise

# FunClip installieren (empfohlen)
pip install funclip

# Whisper installieren
pip install openai-whisper

# FFmpeg (bereits vorhanden)
which ffmpeg  # sollte einen Pfad zurückgeben

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills