editonny: la skill gratis que edita tus vídeos desde Claude Code (cortes, subtítulos y motion en local)

editonny es una skill gratuita y open source para Claude Code y Codex que edita vídeo a partir de lo que le pides en lenguaje natural: corta pausas, respiraciones y tomas falsas, pone subtítulos sincronizados palabra por palabra, nivela el audio, reencuadra a 9:16 o 1:1 y convierte partes de lo que dices en escenas animadas. No hay ventana ni línea de tiempo que manejar: hablas con tu agente, él propone los ajustes, tú los apruebas y te devuelve un MP4 verificado. La transcripción y el render se hacen en tu equipo.

Es justo el tipo de herramienta que buscan quienes graban Reels, clases o anuncios hablando a cámara y pierden horas limpiando silencios. En este artículo leemos su código (versión 1.1.0, último commit del 20 de octubre de 2026) para contarte qué hace de verdad, cómo está montada, qué necesitas instalar y qué limitaciones tiene, sobre todo si trabajas en Windows o editas en español.

Qué es editonny y quién lo hace

• Repositorio: github.com/soumatheusgomes/editonny
• Versión analizada: 1.1.0 (archivo VERSION y manifiesto del plugin de Claude Code).
• Licencia: MIT para el código y la documentación propios. Las fuentes, modelos, efectos de sonido y bibliotecas de terceros conservan su licencia (lo vemos más abajo).
• Autor: Matheus Gomes (@soumatheusgomes), creador brasileño. El README está en inglés, portugués y español.
• Para qué agentes: Claude Code (se invoca con /editonny) y Codex ($editonny).
• Probado en: macOS con Apple Silicon. La propia documentación dice que Windows y Linux "requieren su propia validación".

Una parte del motor viene de otro proyecto MIT, browser-use/video-use: la transcripción, el empaquetado de transcripciones, el render de cortes y la línea de tiempo están adaptados de ahí y mantienen su atribución.

La licencia, en concreto

El código de editonny es MIT: puedes usarlo, modificarlo y venderlo en un servicio de edición sin pedir permiso, siempre que conserves el aviso de copyright. Lo que no cubre la MIT son los recursos incluidos: las fuentes de los subtítulos (Anton, Montserrat, Figtree y Caveat con licencia SIL OFL; Permanent Marker con Apache 2.0), los dos modelos ONNX (YuNet, MIT; MediaPipe Selfie Segmentation, Apache 2.0, cuya ficha prohíbe usarlo para vigilancia o reconocimiento de identidad) y los efectos de sonido (CC0 los grabados, MIT los sintéticos). Todo está inventariado en skills/editonny/engine/THIRD_PARTY_NOTICES.md. Si vas a redistribuir el paquete, lee ese archivo.

Qué hace: los dos servicios

editonny agrupa sus funciones en dos bloques que el README llama "Editor" y "Motion".

Editor

• Limpieza estándar: quita pausas innecesarias, respiraciones audibles, errores, falsos comienzos y repeticiones. Conserva las palabras completas y las pausas intencionadas. Los cortes se miden contra la forma de onda real, no contra un guion.
• Subtítulos sincronizados palabra por palabra, hasta tres palabras en pantalla, en cuatro estilos de letra, y opcionalmente archivos SRT o VTT.
• Audio: normaliza la voz a −14 LUFS (el estándar de redes sociales) con pico máximo de −1 dBTP. Reducción de ruido, música y efectos están apagados por defecto.
• Reencuadre a 9:16, 16:9, 1:1 o 4:5 siguiendo la cara con detección local.
• Varias tomas y varias cámaras: compara tomas, elige las completas y sincroniza cámaras.

Motion

• Un catálogo de 145 escenas animadas: listas de pasos, antes y después, números destacados, pregunta y respuesta, transiciones, punteros, tarjetas de prueba social y paneles por sector (inmobiliaria, salud, nutrición, legal, creadores).
• 79 vídeos originales incluidos en el paquete que usan 35 de esas escenas. Cada proyecto copia solo los clips que necesita.

El propio paquete insiste en algo que conviene repetir: los números, ofertas y testimonios de las escenas son ilustrativos. La skill tiene la orden de sustituirlos por datos que tú le des y de omitir lo que no puedas respaldar, nunca de inventarlos.

Cómo trabaja: la tarjeta de ajustes

Lo que diferencia a editonny de un script de cortes automáticos es su flujo de confirmación, que está escrito en SKILL.md como regla:

1. Le dices a tu agente qué quieres y en qué carpeta están los vídeos.
2. La skill hace solo comprobaciones de lectura: metadatos, fotogramas de muestra y hasta 30 segundos de audio por archivo para detectar el idioma.
3. Te muestra una tarjeta de ajustes con diez apartados (objetivo, vídeos, imagen, formato, idioma, subtítulos, limpieza, sonido, elementos visuales, revisión y entrega). Cada valor lleva una etiqueta: "lo pediste", "de tu vídeo" o "sugerido".
4. Espera tu respuesta. Aunque tu primer mensaje diga "decide tú y sigue", la skill no puede darse por aprobada a sí misma.
5. Con tu "ok", crea el proyecto, transcribe, corta y prepara una muestra de 8 a 15 segundos que revisa el agente (o tú, si lo eliges).
6. Exporta el MP4, pasa un control de calidad y te entrega una tarjeta final con lo que cambió (por ejemplo, "4:52 → 3:31, 18 pausas eliminadas").

El resultado queda en ~/Downloads/editonny/AAAA-MM-DD-titulo/, con exports/ para los vídeos terminados y project/ para los archivos de edición. Las revisiones nunca sobrescriben un final anterior: cada una es v001, v002...

Dos decisiones de diseño que nos parecen acertadas:

• No toca el color. Nada de filtros, "mejoras" ni conversiones HDR a SDR automáticas. Conserva tamaño, fotogramas por segundo y espacio de color del original.
• No añade audio que no pediste. La versión 1.1.0 (commit fix: require explicit requests for added audio) obliga a que música, efectos y ambientes se pidan de forma explícita. "Hazlo dinámico" no basta.

Qué hay por dentro

Si leíste nuestro análisis de HyperFrames, aquí lo verás como motor de render: editonny fija su versión exacta y la descarga con npx en la instalación.

Un detalle útil que pocos mencionan: el helper audit_data.py lee con OCR cada fotograma del vídeo exportado (hasta tres minutos; en vídeos más largos, cuatro por segundo) y avisa si aparecen correos, teléfonos, números de tarjeta válidos o nombres propios. Sirve para no publicar un tutorial con tu correo visible en una esquina.

Instalar editonny en Claude Code

Opción 1: pedírselo al agente

Es el método que recomienda el autor. Abre Claude Code en cualquier carpeta y pega el pedido de instalación del README. La versión en español es esta:

Instala o actualiza la skill editonny para Codex y Claude Code desde https://github.com/soumatheusgomes/editonny. Clona la versión más reciente en una carpeta temporal; yo no voy a descargar nada manualmente. Lee skills/editonny/SKILL.md y sigue su procedimiento de preparación completa. Si editonny ya está instalado, compara las versiones, resume qué cambia y actualízalo con su método de instalación actual: el instalador del repositorio para la instalación compartida (conserva mi configuración y guarda una copia de seguridad de la versión anterior) o el actualizador del host para un plugin gestionado. Prepara herramientas locales compatibles, el motor con dependencias fijadas, el renderizador y navegador en las versiones fijadas, el modelo predeterminado de transcripción, OCR local para comprobar subtítulos y los recursos incluidos antes de la primera edición. Comprueba todo con diagnósticos y una muestra sintética, informa pendientes, elimina el clon temporal y avísame cuándo reiniciar el agente. Pide autorización antes de servicios de pago o de enviar mis archivos.

El agente instalará lo que falte (uv, FFmpeg, Node, Tesseract), descargará el modelo de Whisper y el navegador de HyperFrames, y hará una prueba con un vídeo sintético. Revisa cada comando que te proponga antes de aprobarlo: va a instalar programas del sistema. Si no sabes cómo funcionan las skills, empieza por nuestra guía de skills de Claude Code.

Opción 2: desde la terminal

git clone https://github.com/soumatheusgomes/editonny.git
cd editonny
python3 install.py --target claude
python3 ~/.local/share/editonny/scripts/editonny.py doctor
python3 ~/.local/share/editonny/scripts/editonny.py media status

El instalador guarda una sola copia en ~/.local/share/editonny y crea un enlace en ~/.claude/skills/editonny (o en ~/.agents/skills/editonny para Codex con --target codex; --target both hace los dos). Respeta la variable CLAUDE_CONFIG_DIR si la usas. Con --dry-run ves qué haría sin tocar nada.

Ojo: el mensaje Installation ready. del instalador solo significa que registró la skill y sincronizó el entorno de Python. No instala FFmpeg ni Node, no descarga el modelo de transcripción ni el navegador de render. Para eso, pide al agente que lea skills/editonny/SKILL.md y siga su procedimiento de preparación, o hazlo a mano con las versiones que fija el paquete.

Ten en cuenta el tamaño: la carpeta de recursos visuales (escenas, 79 vídeos, imágenes, fuentes y audio) ocupa unos 463 MB, a los que se suman el modelo large-v3-turbo y el navegador de render.

Cuando termine, reinicia Claude Code y escribe /editonny.

Tu primera edición

El README propone un pedido así (puedes escribirlo en español; la skill responde en el idioma de la conversación):

/editonny
Edita un vídeo vertical de 45 segundos con los clips de /ruta/a/mis-videos.
Quédate con las tomas completas, limpia pausas, respiraciones y errores, y pon subtítulos claros.
Usa escenas visuales solo donde expliquen la historia.
Verifica una muestra de 8 a 15 segundos antes de terminar la exportación.

La skill no empezará a cortar con este mensaje: primero te enseña la tarjeta de ajustes. Ahí es donde decides lo importante, por ejemplo "sin subtítulos", "mantén la pausa del segundo 0:42" o "añade música". Si cambias algo, la vuelve a mostrar con un ✏️ en las filas modificadas.

Para pedidos de ejemplo, el repositorio trae una guía web (una app Next.js en web/) con un generador de pedidos, las 145 escenas y 54 pedidos de ejemplo en tres idiomas. Se arranca con npm ci y python3 editonny.py guide en http://localhost:4173. La guía nunca recibe ni sube vídeos.

Servicios externos: opcionales y con permiso

Nada de lo anterior necesita una clave de API de un LLM: el trabajo lo dirige tu propia sesión de Claude Code. Hay integraciones opcionales, y la skill debe pedir autorización antes de usarlas porque envían datos fuera de tu equipo o cuestan dinero:

• Pexels y Wikimedia Commons para buscar imágenes de archivo.
• OpenRouter para generar imágenes (de pago).
• ElevenLabs para generar música o efectos (de pago, con sus propias reglas de uso comercial).

Lo que tienes que saber si usas Windows o editas en español

• Windows no está validado. Las pruebas documentadas en docs/validation.md son en macOS con Apple Silicon. En Windows el instalador crea enlaces de carpeta que pueden necesitar el modo de desarrollador o permisos de administrador; si fallan, la documentación pide reportarlo en vez de crear una segunda copia.
• Sin Mac M, la transcripción va por CPU o CUDA. En Apple Silicon usa MLX Whisper; en el resto, Faster Whisper. Con el modelo large-v3-turbo y sin GPU NVIDIA, cuenta con que transcribir tarde bastante más que en un Mac.
• El español está bien soportado. Whisper transcribe español, la skill conserva el idioma original del audio y no traduce salvo que lo pidas. La tarjeta distingue idioma de la conversación, del habla, de la transcripción y de los subtítulos.
• El OCR en Windows es Tesseract. Lo necesitas para que la verificación de subtítulos no quede como "no comprobada"; la skill prueba primero el idioma basis y luego eng.

editonny frente a otras opciones

Si quieres arrastrar clips a mano, Concat o CapCut encajan mejor. editonny brilla cuando tu material es una persona hablando y lo que te come el tiempo es limpiar, subtitular y adaptar formatos.

¿A quién le compensa?

• Creadores y negocios que graban vídeos hablados (Reels, TikTok, clases, anuncios de venta) y ya pagan Claude Code o Codex.
• Agencias que editan muchos vídeos parecidos para clientes: el catálogo de escenas por sector y la licencia MIT permiten usarlo en un servicio de pago.
• No le compensa a quien no use un agente de IA: la instalación pide Python, FFmpeg y Node, y no hay interfaz para editar a mano.

Errores y avisos frecuentes

• MISSING · <herramienta> en editonny.py doctor: falta FFmpeg, uv, Node o el OCR en el PATH. Instálalos desde sus fuentes oficiales y vuelve a ejecutar doctor.
• "Installation ready." pero la primera edición se para: el instalador no prepara el modelo ni el navegador. Pide al agente la preparación completa de references/setup.md.
• El enlace de la skill falla en Windows: activa el modo de desarrollador o ejecuta la terminal como administrador.
• Se bloquea un subtítulo o escena sobre vídeo HDR: los overlays nativos sobre HDR y los metadatos Dolby Vision están bloqueados a propósito. Te ofrecerá el corte limpio en HDR o una versión SDR que tienes que aceptar.
• "Update check unavailable": no pudo consultar GitHub. No significa que estés al día; la skill sigue con la versión instalada.

Preguntas frecuentes

¿editonny es gratis? Sí. El código es MIT y no cobra nada. Lo que sí pagas es tu suscripción a Claude Code o Codex, y los servicios externos opcionales si decides usarlos.

¿Sube mis vídeos a algún servidor? No por defecto. Transcripción, cortes y render se hacen en tu equipo. Solo se envían datos a Pexels, OpenRouter o ElevenLabs si lo autorizas.

¿Funciona en Windows? Puede funcionar, pero no está validado por el autor. Necesitarás Tesseract para el OCR y quizá el modo de desarrollador para los enlaces.

¿Necesito una tarjeta gráfica? No es obligatoria. Ayuda a transcribir más rápido con Faster Whisper; sin ella, la transcripción va por CPU.

¿Puedo usarlo para editar vídeos de clientes y cobrar? La licencia MIT lo permite. Revisa los avisos de terceros si usas las fuentes, sonidos o escenas incluidas, y no publiques las cifras de ejemplo de las escenas como si fueran reales.

¿Edita vídeos en español? Sí. Transcribe y subtitula en el idioma que se habla en el vídeo y te responde en el idioma en que le escribas.

Conclusión

editonny es la forma más completa que hemos visto de convertir a Claude Code en editor de vídeo: tiene un flujo de aprobación claro, no toca el color ni añade audio por su cuenta, verifica el resultado con medidas reales y su licencia MIT deja usarlo en un negocio. A cambio, la instalación es pesada y fuera de macOS vas por terreno sin validar. Nosotros lo revisamos desde el código, sin ejecutarlo; si lo pruebas en Windows, empieza con un clip corto y doctor para ver qué falta. Para seguir, mira cómo funciona su motor de render en nuestro análisis de HyperFrames.