Communitygithub.com

Asistente de Recorte de Video

Asistente automático de edición de video. Basado en FFmpeg, extrae clips destacados, genera subtítulos, recorta duración y produce videos cortos para múltiples plataformas.

¿Qué es Asistente de Recorte de Video?

Este skill, llamado Video Clip Assistant, es un asistente de edición de video automática que se basa en FFmpeg para ofrecer funcionalidades como corte por línea de tiempo, extracción de fragmentos clave mediante ASR (reconocimiento automático del habla), grabación de subtítulos SRT, exportación de videos cortos en formatos optimizados para redes sociales (9:16, 1:1, 16:9) y extracción automática de momentos destacados de videos largos. Es útil para desarrolladores, creadores de contenido y usuarios que necesitan automatizar tareas comunes de edición de video sin intervención manual. El skill está diseñado para entornos de línea de comandos (CLI) con Python, y es compatible con cualquier plataforma que tenga FFmpeg instalado (Linux, macOS, Windows). Su funcionamiento se basa en scripts Python modulares (cut_video.py, burn_subtitles.py, export_social.py, extract_highlights.py, generate_subtitles.py), que invocan FFmpeg y opcionalmente servicios ASR como Whisper o FunClip. Proporciona flujos de trabajo típicos para editar reuniones grabadas, agregar subtítulos a videos o generar múltiples clips cortos para TikTok, Instagram y YouTube.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Asistente de Recorte de Video?

Asistente automático de edición de video. Basado en FFmpeg, proporciona funciones de corte de video, generación de subtítulos y exportación de videos cortos.

Capacidades principales

  1. Corte por línea de tiempo — Extraer fragmentos por marcas de tiempo
  2. Corte por palabras clave — Encontrar fragmentos basados en palabras clave mediante ASR
  3. Grabación de subtítulos — Incrustar subtítulos SRT en el video
  4. Exportación de videos cortos — Recortar a proporciones 9:16/1:1/16:9
  5. Extracción de momentos destacados — Extraer automáticamente clips destacados de videos largos

Inicio rápido

Cortar por tiempo

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

Extraer múltiples segmentos

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

Grabar subtítulos

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

Exportar video corto

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

Descripción de scripts

scripts/cut_video.py

Cortar video por línea de tiempo.

python3 scripts/cut_video.py \
  --input <archivo de video> \
  --start <segundos> \
  --duration <segundos> \
  [--segments "0-30,60-90"] \
  --output <salida>

scripts/burn_subtitles.py

Incrustar subtítulos SRT en el video.

python3 scripts/burn_subtitles.py \
  --input <video> \
  --srt <archivo de subtítulos> \
  --output <salida>

Permite personalizar posición, tamaño de fuente y color de los subtítulos.

scripts/export_social.py

Exportar video en formatos adaptados a múltiples plataformas.

python3 scripts/export_social.py \
  --input <video> \
  --format <vertical|square|horizontal> \
  --duration <segundos> \
  --output <directorio de salida>
FormatoProporciónUso
vertical9:16TikTok / Kuaishou / Xiaohongshu
square1:1Instagram
horizontal16:9YouTube / Bilibili

scripts/extract_highlights.py

Extraer automáticamente fragmentos destacados de un video largo.

python3 scripts/extract_highlights.py \
  --input <video> \
  --num-clips <número de fragmentos> \
  --min-duration <segundos mínimos> \
  --output <directorio de salida>

Utiliza un algoritmo de detección de escenas para localizar puntos de transición interesantes.

scripts/generate_subtitles.py

Generar archivo de subtítulos SRT (requiere servicio ASR).

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

Flujos de trabajo típicos

Flujo 1: Extraer 3 fragmentos destacados de una grabación de reunión

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

# 2. Exportar cada uno a formato TikTok
for f in ./clips/*.mp4; do
  python3 scripts/export_social.py \
    --input "$f" \
    --format vertical \
    --output ./shorts/
done

Flujo 2: Agregar subtítulos a un video

# 1. Generar subtítulos
python3 scripts/generate_subtitles.py \
  --input video.mp4 \
  --provider whisper \
  --output video.srt

# 2. Grabar subtítulos
python3 scripts/burn_subtitles.py \
  --input video.mp4 \
  --srt video.srt \
  --output subtitled.mp4

Flujo 3: Generar múltiples videos cortos de un solo paso

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

Requisitos del entorno

  • Obligatorio: FFmpeg (ffmpeg / ffprobe)
  • Opcional: FunClip (edición de video ASR de código abierto de Alibaba)
  • Opcional: Whisper (modo local o API)

Referencia de instalación

# Instalar FunClip (recomendado)
pip install funclip

# Instalar Whisper
pip install openai-whisper

# FFmpeg (ya instalado)
which ffmpeg  # debe devolver una ruta

Individual skills in this repo

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

Skills relacionados