Communitygithub.com

auto-video-editor-windows

Úselo cuando un usuario de macOS o Windows señale un video local y desee editarlo, limpiarlo, transcribirlo, subtitularlo o recortarlo para obtener momentos destacados de transmisiones en vivo.

¿Qué es auto-video-editor-windows?

Esta habilidad permite editar videos localmente en macOS o Windows utilizando HotClip y FFmpeg, sin necesidad de cargar archivos a la nube ni depender de un endpoint LLM. Es ideal para tareas como limpieza de videos (eliminación de muletillas), extracción de momentos destacados a partir de la transcripción, generación de subtítulos precisos con sincronización de tiempo, y cortes de video con FFmpeg. El flujo de trabajo se basa en la transcripción local con HotClip ASR con marcas de tiempo por palabra, donde el asistente selecciona manualmente los fragmentos relevantes de la transcripción y los renderiza como un solo video editado con subtítulos incrustados y un archivo SRT adicional. Está diseñado para ser instalado como una habilidad estándar de agente en agentes como Claude Code, Cursor o Codex, y requiere Git, Node.js LTS, FFmpeg y HotClip instalados previamente. La habilidad verifica la integridad de los archivos exportados y proporciona un informe de edición en Markdown con enlaces de control de calidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cresjq-sketch/agent-skills/tree/HEAD/skills/auto-video-editor-windows

Preguntar en tu IA favorita

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

Documentación

Editor de video automático para macOS y Windows

Utilice HotClip y FFmpeg locales para crear ediciones de video revisables en macOS o Windows. Instale esta Habilidad Estándar de Agente en el agente actual usando el instalador nativo de habilidades de ese agente. Requisitos: macOS o Windows 10+, acceso a Internet y varios GB de espacio libre en disco. Al prepararse para editar, instale Git, Node.js LTS, FFmpeg, HotClip y el modelo de voz local de HotClip con el administrador de paquetes del sistema operativo, luego use la CLI de HotClip. En macOS, Homebrew es el administrador de paquetes habitual; en Windows, use winget. No se requiere un script de PowerShell de repositorio, Ollama ni un endpoint LLM para la selección basada en transcripciones. Reinicie el agente después de instalar la habilidad si es necesario.

Flujo de trabajo

  1. Analice el origen con ffprobe: duración, tamaño de fotograma y flujos de audio/video. Conserve el origen y cree una nueva carpeta de salida hermana 成品_自动精剪_YYYY-MM-DD; use un sufijo numérico si ya existe.
  2. Para videos de más de cinco minutos, elija la cantidad de momentos destacados de la transcripción: normalmente 1–2 para menos de 15 minutos, 2–4 para 15–60 minutos y 3–5 para más de 60 minutos. Estos son límites máximos, no cuotas; devuelva menos cuando no haya suficientes momentos distintos, completos y útiles. Evite temas repetitivos. Para clips terminados más cortos, limpie todo el clip de manera conservadora. Si el usuario solicita conservar la grabación completa, no extraiga momentos destacados.
  3. Transcriba localmente con el ASR de HotClip con marcas de tiempo por palabra. Revise la transcripción con respecto al audio antes de usarla para cortes o subtítulos. Los comandos automáticos de highlights y clip de HotClip requieren un endpoint LLM configurado; en este flujo de trabajo sin LLM, el asistente activo selecciona momentos de la transcripción y los renderiza con FFmpeg. No cargue metraje ni transcripciones.
  4. Elimine las muletillas por defecto. Revise los sonidos de vacilación aislados como 嗯, 呃, 额, 唔, 诶, um, uh y las repeticiones de tartamudeo inmediatas obvias. Verifique cada candidato en el audio antes de cortar. Trate 啊, 这/这个, 那个, 就是 y 然后 como dependientes del contexto: elimínelos solo cuando sean claramente una vacilación no semántica o un andamiaje repetido, y la oración siga siendo natural. Mantenga énfasis significativo, referencias, transiciones y cualquier palabra dudosa. Nunca use un reemplazo de texto ciego en toda la transcripción. Corte solo segmentos de palabras completos con un pequeño límite de audio natural; conserve las respiraciones y el tono de la sala a menos que claramente no sean deseados.
  5. Produzca subtítulos para cada clip hablado por defecto. Cree subtítulos precisos en chino a partir de la transcripción revisada, elimine las palabras que realmente se cortaron y ajuste el tiempo de todas las pistas según la línea de tiempo de salida editada. Mantenga líneas cortas legibles (normalmente una o dos líneas), puntuación natural y márgenes seguros. Entregue tanto un MP4 con subtítulos incrustados como un SHR lateral coincidente. Si el usuario solicita no subtítulos, omita ambos solo después de seguir esa solicitud. Nunca presente un plan de subtítulos sin incrustar como una exportación subtitulada.
  6. Establezca los límites de los momentos destacados y los cortes de muletillas en palabras y oraciones completas. Verifique la transcripción y el audio alrededor de cada inicio y final; nunca confíe solo en midWordCuts: 0. Ensamble los intervalos retenidos en una edición y mantenga una lista de decisiones de edición. Para un tiempo de origen t dentro de un intervalo retenido [source_start, source_end], calcule su tiempo de salida como t - source_start + cumulative_duration_of_prior_retained_intervals; omita las palabras eliminadas por cortes de muletillas. Construya el SRT en esta línea de tiempo de salida, use el mismo mapa de intervalos para la concatenación de audio/video, luego incruste el SRT en el MP4 renderizado con el filtro de subtítulos de FFmpeg.
  7. Conserve la imagen principal y los gráficos del origen. Para el banner azul recurrente de transmisión en vivo, reemplace solo su título de episodio anterior con un título conciso y fiel de la transcripción; conserve el encabezado permanente y los gráficos decorativos. Coloque los subtítulos incrustados cerca de la parte inferior con aproximadamente 40 px de espacio libre a 1080×1920. Inspeccione un fotograma renderizado para obtener texto legible sin recortes.
  8. Conserve el audio continuo por defecto, excepto para muletillas verificadas, silencios no deseados o ediciones solicitadas por el usuario. Trate el silencio de VAD como un candidato: si un corte propuesto se superpone con una palabra de ASR, inspeccione el audio y conserve el habla. Para superposiciones visuales, copie el flujo de audio renderizado cuando sea posible y compare su hash de paquete de audio con el renderizado previo a la superposición.
  9. Verifique cada exportación con ffprobe, decodificación completa de FFmpeg, verificaciones de flujos de audio/video, escaneo de fotogramas negros, escaneo de silencio, duración, presencia/sincronización de subtítulos y verificaciones de palabras de apertura y cierre. Escuche el inicio, la mitad y el final del renderizado. Mapee los silencios largos de vuelta al origen e informe si estaban en la grabación o fueron introducidos por la edición. Exponga las advertencias de QA no resueltas e informe solo las verificaciones realmente realizadas.
  10. No publique ni cargue. Entregue rutas absolutas a cada MP4 y SRT, duración, carpeta de salida y un informe de edición en Markdown con enlaces de QA.

Comandos

Configuración de plataforma y comandos

Use la CLI del repositorio en cualquier plataforma. Instale primero Git, Node.js LTS, FFmpeg y pnpm; clone HotClip de https://github.com/xixihhhh/hotclip en un directorio de usuario estable y ejecute pnpm install allí. La primera transcripción local de HotClip descarga su modelo de voz. No configure variables de entorno LLM para este flujo de trabajo basado en transcripciones.

macOS (zsh), después de instalar Homebrew si es necesario:

brew install git node ffmpeg
corepack enable
corepack prepare pnpm@latest --activate
mkdir -p "$HOME/Library/Application Support/HotClip"
git clone --depth 1 https://github.com/xixihhhh/hotclip.git "$HOME/Library/Application Support/HotClip/source"
cd "$HOME/Library/Application Support/HotClip/source"
pnpm install
pnpm cli transcribe "$HOME/Movies/recording.mp4" --json > "$HOME/Movies/transcript.json"

Windows PowerShell, desde el directorio fuente de HotClip después de instalar Git, Node.js LTS y FFmpeg con winget:

corepack enable
corepack prepare pnpm@latest --activate
git clone --depth 1 https://github.com/xixihhhh/hotclip.git "$env:LOCALAPPDATA\HotClip\app"
Set-Location "$env:LOCALAPPDATA\HotClip\app"
pnpm install
pnpm cli transcribe 'C:\Videos\recording.mp4' --json > 'C:\Videos\transcript.json'

El DMG oficial de HotClip para macOS es actualmente para Apple Silicon. La aplicación no está notarizada por Apple; use la guía de instalación oficial si Gatekeeper la bloquea. El flujo de trabajo de CLI fuente anterior es independiente de esa descarga de GUI. Verifique la versión actual de HotClip y la guía de instalación para compatibilidad con Intel Mac antes de instalar allí.

La transcripción se ejecuta localmente. Elija un número dentro de los límites de duración según momentos distintos y autónomos en la transcripción; nunca llene el máximo solo porque existe. Siempre renderice subtítulos hablados y un SRT coincidente a menos que el usuario solicite omitirlos. Elimine solo los segmentos de muletillas verificados individualmente, luego ajuste el tiempo de las pistas de subtítulos a la línea de tiempo de salida. Renderice solo después de verificar los límites de la transcripción y la seguridad del audio.

Skills relacionados