Repolode
Enviar
kajisho5

kajisho5/ffmpeg-skill

Un Agent Skill y servidor MCP que ofrece a agentes de programación como Claude Code, Cursor y Codex 42 herramientas locales de edición de video y audio con FFmpeg.

Alternativa open source a:DescriptCapCut

Ver en GitHubSitio web
Estrellas
2,000
Forks
164
Issues abiertos
4
Último commit
anteayer

¿Qué es?

ffmpeg-skill permite que un agente de programación edite archivos de video y audio mediante scripts de Python estructurados que ejecutan ffmpeg y ffprobe localmente. Sus 42 herramientas permiten cortar y unir clips, eliminar silencios, ajustar el metraje a una duración o relación de aspecto, incrustar subtítulos, añadir superposiciones, convertir de HDR a SDR, normalizar el volumen, sincronizar grabaciones y exportar con ajustes para plataformas como TikTok, Reels, YouTube y X.

Cada herramienta recibe argumentos tipados en lugar de cadenas de filtros sin procesar, admite las opciones --dry-run y --json, e informa de un análisis del resultado. Un contrato legible por máquinas describe las entradas y salidas de cada herramienta, y las mismas herramientas también están disponibles a través de MCP. El procesamiento funciona sin conexión, no requiere claves de API y solo utiliza la biblioteca estándar de Python, aunque es necesario tener instalados ffmpeg y python3.

El proyecto está dirigido a desarrolladores que quieren que un agente se encargue de las ediciones rutinarias de metraje local sin subirlo a un servicio en la nube, y que también compruebe el resultado antes de indicar que terminó.

Funciones clave

  • 01Cortar y unir clips, y eliminar silencios, con copia de streams sin pérdida cuando sea posible.
  • 02Ajustar el metraje a una duración y relación de aspecto determinadas, incluido el recorte 9:16 y el relleno con desenfoque.
  • 03Incrustar subtítulos con tiempos al estilo karaoke y ajuste de línea a las zonas seguras de cada plataforma.
  • 04Normalizar el volumen según los objetivos EBU R128 y convertir metraje HDR a SDR.
  • 05Exponer todas las herramientas a través de MCP, con un contrato generado a partir de las definiciones de argparse.

Casos de uso

  • Permitir que un agente convierta una grabación larga en un clip vertical de 60 segundos para Reels o TikTok.
  • Normalizar el volumen por lotes y exportar entregables para podcasts o redes sociales desde una carpeta.
  • Añadir subtítulos incrustados y superposiciones al metraje sin subirlo a un editor en la nube.
  • Crear un pipeline de video con scripts que compruebe cada resultado con ffprobe antes de pasarlo a la siguiente etapa.

Inicio rápido

  1. 1

    Instalar la skill para Claude Code

    npx ffmpeg-skill
  2. 2

    Comprobar que estén disponibles ffmpeg, ffprobe y los componentes necesarios

    npx ffmpeg-skill doctor
  3. 3

    Leer el contrato de herramientas legible por máquina

    npx ffmpeg-skill contract --json | head -40

Antes de usarlo

  • Es necesario que ffmpeg y python3 ya estén instalados y disponibles en PATH.
  • Las copias instaladas por el instalador no se actualizan automáticamente; vuelve a ejecutar el comando de instalación para actualizarlas.
  • Algunas herramientas, como caption.py, necesitan componentes de FFmpeg, como el filtro subtitles, que pueden no estar incluidos en una instalación básica de Homebrew.

Temas

#ffmpeg#video-editing#agent-skills#mcp#audio-processing#captions#loudness-normalization#ai-agents#claude-code#codex

Preguntas frecuentes

¿Qué es ffmpeg-skill?
Un Agent Skill y servidor MCP que ofrece a agentes de programación como Claude Code, Cursor y Codex 42 herramientas locales de edición de video y audio con FFmpeg. ffmpeg-skill permite que un agente de programación edite archivos de video y audio mediante scripts de Python estructurados que ejecutan ffmpeg y ffprobe localmente. Sus 42 herramientas permiten cortar y unir clips, eliminar silencios, ajustar el metraje a una duración o relación de aspecto, incrustar subtítulos, añadir superposiciones, convertir de HDR a SDR, normalizar el volumen, sincronizar grabaciones y exportar con ajustes para plataformas como TikTok, Reels, YouTube y X.
¿ffmpeg-skill es gratuito? ¿Qué licencia tiene?
ffmpeg-skill es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ffmpeg-skill sigue mantenido?
Mantenimiento activo. El último commit de ffmpeg-skill fue el 17 oct 2026.
¿Para qué puedo usar ffmpeg-skill?
Permitir que un agente convierta una grabación larga en un clip vertical de 60 segundos para Reels o TikTok. Normalizar el volumen por lotes y exportar entregables para podcasts o redes sociales desde una carpeta. Añadir subtítulos incrustados y superposiciones al metraje sin subirlo a un editor en la nube. Crear un pipeline de video con scripts que compruebe cada resultado con ffprobe antes de pasarlo a la siguiente etapa.
¿Cómo se instala ffmpeg-skill?
Instalar la skill para Claude Code: npx ffmpeg-skill Comprobar que estén disponibles ffmpeg, ffprobe y los componentes necesarios: npx ffmpeg-skill doctor Leer el contrato de herramientas legible por máquina: npx ffmpeg-skill contract --json | head -40
¿Dónde consigo ffmpeg-skill?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/kajisho5/ffmpeg-skill

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados