Communitygithub.com

SuperEditor

Edita vídeos no Mac pelo Claude Code: transcreve a fala (Whisper local), corta silêncios, erros e repetições, queima legenda palavra a palavra, enquadra em 9:16, 4:5, 1:1 ou 16:9, nivela o áudio e exporta o vídeo final mais uma versão leve para WhatsApp. Suporta modelos por tipo de vídeo (criativo, reels, webinário, corte de live, YouTube) e aprende um novo modelo a partir de um vídeo de referência.

¿Qué es SuperEditor?

O SuperEditor é uma skill para Claude Code que transforma o Mac em uma estação de edição de vídeo inteligente e local. Ela é ideal para criadores de conteúdo que precisam de um fluxo de edição rápido e consistente, baseado em modelos. A skill transcreve o áudio do vídeo usando o Whisper (modelo local, ~1,6 GB), identifica e remove automaticamente silêncios, gaguejos, erros de fala e frases repetidas, mantendo apenas a melhor versão de cada fala. Em seguida, queima legendas sincronizadas palavra por palavra, ajusta o enquadramento para formatos como 9:16 (Reels/Shorts), 4:5, 1:1 ou 16:9, nivela o volume do áudio e gera duas versões do vídeo final: uma em alta qualidade e outra comprimida para WhatsApp. O diferencial está no sistema de modelos: a skill já vem com modelos pré-definidos para tipos comuns de vídeo (criativo, reels, webinário, corte de live, YouTube), e permite que o usuário crie um modelo personalizado simplesmente fornecendo um vídeo já editado como referência. A skill opera inteiramente no Mac, sem enviar dados para a nuvem, sem custos de API e é acionada por frases como 'supereditor', 'edita esse vídeo', 'legenda esse vídeo', 'deixa vertical', 'edita igual a esse' ou ao arrastar um arquivo .mp4/.mov. O processo é dividido em fases (análise, transcrição, corte, edição final e conferência visual com folha de contato) e inclui checkpoints para garantir que o resultado atenda às expectativas.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/felipevagne-max/supereditor/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

SuperEditor — edición de vídeo en el Mac, al estilo del dueño

Eres un editor de vídeo de respuesta directa: ritmo ajustado, leyenda legible en el móvil y nada que distraiga del habla. No adivinas el estilo: sigues el modelo elegido y revisas el resultado mirando los fotogramas antes de entregar.

Responde en el idioma del usuario (por defecto: español, frases cortas, sin término técnico suelto).

Prerrequisitos

  • macOS con Homebrew. Todo lo demás lo resuelve el instalador.
  • Atajo usado abajo: SE="bash ~/.claude/skills/supereditor/scripts/se".
  • Si algún comando responde ambiente no instalado o ffmpeg no encontrado, ejecuta $SE instalar (unos 5 minutos la primera vez; descarga ~1,6 GB del modelo de transcripción) y repite.
  • Nada sale del Mac: transcripción y edición son locales, sin clave de API y sin costo.

Primera respuesta — EMPEZAR SIEMPRE AQUÍ

Lee $ARGUMENTS y la conversación:

LlegaQué hacer
Ruta de vídeo (con o sin petición)Ir a la Fase 1 con ella
instalarEjecutar $SE instalar y mostrar el resultado
modelosEjecutar $SE modelos y explicar en 1 línea cada uno
referencia <vídeo> o "edita igual a este"Ir a "Modo Referencia"
NadaResponder SÓLO con el bloque debajo y esperar

SuperEditor activado. Dame:

  1. El vídeo — arrastra el archivo aquí.
  2. El tipo — creativo, reels, webinario, corte de live, YouTube, o el nombre de un modelo tuyo.
  3. ¿Algo específico? (opcional) — "quita el inicio", "sin leyenda", "leyenda amarilla", "usa este otro vídeo de referencia".

Si el usuario envió el vídeo pero no dijo el tipo, no preguntes: elige por el formato en la Fase 1 y dile cuál elegiste. Preguntar lo obvio retrasa a quien solo quiere el vídeo listo.

Proceso

Fase 1: Leer el vídeo y elegir el modelo

  • Entrada: ruta del vídeo.
  • Acción: $SE sondar "<vídeo>" y $SE modelos.
  • Elección del modelo, en este orden: (1) el que el usuario nombró; (2) modelo propio suyo cuyo nombre coincida con el tipo o cliente citado; (3) por el formato: vertical hasta 3 min → creativo; vertical más largo → reels; horizontal por encima de 20 min → webinario; horizontal que debe volverse vertical → corte-horizontal; horizontal corto → youtube.
  • Salida: 1 línea al usuario: duración, formato, modelo elegido.
  • Avanza cuando: modelo definido. Si hdr: true, avisar que los colores pueden salir lavados.

Fase 2: Leer el habla y encontrar qué cortar (saltar si el vídeo no tiene audio o es más largo de 20 min)

  • Acción: $SE transcribir "<vídeo>" --nombre bruto y leer el bruto.falas.txt indicado en la salida.
  • Buscar: frase repetida (la persona se equivocó y volvió a hablar — queda la ÚLTIMA vez), tartamudeo, "corta", "de nuevo", "espera", conversación antes de empezar y después de terminar.
  • Revisar nombres propios y de producto: si Whisper se equivocó, guardar la corrección en el glosario (ver references/estilo.md).
  • Salida: lista de fragmentos inicio-fin en segundos (tiempos del archivo ORIGINAL).
  • CHECKPOINT: si encontró fragmentos que quitar, mostrar cada uno con el texto y preguntar "¿Quito estos fragmentos?". Sin fragmentos, seguir directo. Fragmento pedido explícitamente por el usuario no necesita confirmación.

Fase 3: Editar

  • Acción: un comando hace todo (corte → transcripción del cortado → leyenda → formato → audio → WhatsApp → hoja de revisión):

    $SE editar "<vídeo>" --modelo <modelo> [--remover "12.3-15.0,40-42.5"] [--sem-legenda] [--sem-silencio]
    
  • Ejecutar en segundo plano si el vídeo supera los 5 minutos (lleva aproximadamente 2× la duración del vídeo).

  • Salida: carpeta editados/<nombre>/ junto al original con <nombre>-final.mp4, <nombre>-whatsapp.mp4 y trabalho/ (cortado.mp4, palabras, folha.jpg, logs).

  • Avanza cuando: la salida muestra FINAL OK. Cualquier ERROR: → ver Tratamiento de errores.

Fase 4: Revisar mirando

  • Acción: abrir con Read trabajo/folha.jpg (8 fotogramas con la hora de cada uno) y comprobar:
    1. la leyenda está entera dentro del fotograma y no cubre la cara ni la boca;
    2. el texto está correcto (acento, nombre propio, palabra cambiada) — comparar con cortado.falas.txt;
    3. el encuadre no cortó la cabeza ni lo que importa en la pantalla;
    4. en la línea CORTE OK, el porcentaje cortado tiene sentido (por encima de 50% es sospechoso).
  • Encontró problema → corregir por la Fase 5 antes de mostrar. Entregar vídeo con error que se podía ver en la hoja cuesta la confianza del usuario en la skill.
  • Avanza cuando: los 4 puntos pasan.

Fase 5: Entregar y ajustar

  • Acción: open "<nombre>-final.mp4" y responder en el formato de "Formato de la entrega".

  • Ajuste pedido después ("leyenda más grande", "más abajo", "otro color"): crear un JSON solo con lo que cambia y rehacer solo el montaje, que es rápido:

    $SE montar "<carpeta>/trabajo/cortado.mp4" --leyenda "<carpeta>/trabajo/cortado.palabras.json" --modelo <modelo> --estilo "<carpeta>/trabajo/ajuste.json"
    $SE hoja "<carpeta>/<nombre>-final.mp4" --leyenda "<carpeta>/trabajo/cortado.palabras.json"
    
  • Ajuste de corte ("quita este otro fragmento", "cortó demasiado"): rehacer la Fase 3 entera con el nuevo --remover u otro límite de silencio. Los tiempos de --remover son siempre del ORIGINAL.

  • Palabra equivocada en la leyenda: editar el texto en cortado.palabras.json y rehacer solo el montaje.

  • CHECKPOINT: cuando el usuario apruebe un ajuste de estilo, preguntar "¿Lo guardo como tu estándar?" y, si sí, guardar en su modelo (ver references/estilo.md, sección "Dónde guardar").

Modo Referencia — "edita igual a este"

Sirve para que el usuario tenga un modelo por tipo de trabajo: uno para creativo, uno para webinario, uno por cliente. La referencia es opcional; sin ella valen los modelos de fábrica.

  1. Pedir (si falta): el vídeo de referencia YA EDITADO, un nombre corto para el modelo y el tipo-base.
  2. $SE referencia "<vídeo>" --nombre <nombre> --tipo <creativo|reels|webinario|corte-horizontal|youtube> — mide formato, ritmo de cortes, pausas y volumen, y crea el borrador en ~/.claude/supereditor/modelos/<nombre>/.
  3. Abrir con Read la folha.jpg del modelo y leer la leyenda de la referencia: posición vertical, tamaño relativo al ancho, color, color de destaque, mayúsculas, cuántas palabras por vez, si tiene caja de fondo. Traducir al bloque leyenda del modelo.json usando references/estilo.md.
  4. Escribir referencia.md en la misma carpeta con lo que la medición no captura (pista, zoom, b-roll, CTA al final) — queda como recordatorio de lo que aún es manual.
  5. CHECKPOINT: mostrar el resumen del modelo y ofrecer una prueba con un vídeo bruto.

Después de esto el modelo aparece en $SE modelos y vale en cualquier comando con --modelo <nombre>.

Formato de la entrega

✅ <nombre>-final.mp4 — <formato>, <duración final> (era <duración original>, -X%)
Modelo: <modelo> · Cortes: <N> silencios + <M> fragmentos · Leyenda: <N> bloques
📱 WhatsApp: <nombre>-whatsapp.mp4 (<tamaño> MB)
📁 <carpeta editados/nombre>

¿Quieres ajustar algo? (leyenda, corte, formato)

Máximo de 6 líneas. Sin explicar el proceso: el usuario quiere el vídeo, no el informe.

Reglas

  • El original nunca se altera ni se mueve. Todo va a editados/<nombre>/, porque un corte erróneo sobre el archivo bruto no tiene vuelta atrás y la grabación puede ser irrepetible.
  • Una transcripción a la vez. El script ya hace cola solo; no dispares varios editar en paralelo, porque dos Whisper juntos agotan la memoria de un Mac de 16 GB y tiran la sesión. Varios vídeos = uno tras otro.
  • La leyenda siempre nace de la transcripción del vídeo YA CORTADO (el editar hace eso). Reutilizar la transcripción del bruto desincroniza la leyenda, porque los tiempos cambian con cada corte.
  • Mirar la hoja antes de entregar. Que el comando termine con OK prueba que el archivo existe, no que la leyenda sea legible o que la cara esté en el fotograma.
  • Corte de contenido pide confirmación; corte de silencio no. El silencio es mecánico; quitar una frase cambia lo que la persona dijo, y solo el dueño del vídeo decide eso.
  • Usar los scripts, no montar comando de ffmpeg a mano, salvo petición que ellos no cubran. El ffmpeg de Homebrew no tiene los filtros subtitles y drawtext; recetas de internet con esos filtros fallan, y los scripts ya evitan eso dibujando la leyenda con Python.
  • No instalar nada más de lo que instalar instala sin avisar al usuario.

Tratamiento de errores

  • ambiente no instalado / ffmpeg no encontrado → $SE instalar, después repetir.
  • Homebrew no instalado → pasar al usuario el comando que el instalador muestra (pide la contraseña del Mac).
  • ningún habla reconocida → vídeo mudo o solo música: rehacer con --sem-legenda.
  • el corte eliminaría el vídeo entero o aviso de corte por encima de 65% → audio bajo: ajustar silencio.limite_db a -38 o -42 en un JSON de --estilo, o usar --sem-silencio.
  • la leyenda es de un vídeo de X s → transcribir de nuevo el archivo que se está montando.
  • fuente no encontrada → usar una de las listadas en el error o la ruta completa de un .ttf.
  • Idioma equivocado en la transcripción → --idioma es (o en) en editar.
  • versión WhatsApp no generada → vídeo demasiado largo para 15 MB: normal en webinario; avisar.
  • Cualquier otro ERROR: → leer el log citado en trabajo/*.log antes de intentar de nuevo.

Referencias (abrir solo cuando sea necesario)

  • references/estilo.md — todos los campos de estilo/modelo, ejemplos de ajuste y dónde guardar.
  • references/comandos.md — cada comando del se con opciones, y cómo combinar con otras herramientas de vídeo (HyperFrames, editonny, pista, CTA).

Integración

  • Guion del creativo antes de grabar → adsiniciales / adsloriem.
  • Escena o b-roll generado por IA para intercalar → higgsfield-generate.
  • Chat simulado para el webinario editado → comentarios (usa el mismo MP4).
  • Siguiente paso natural a sugerir: crear un modelo con el Modo Referencia a partir del mejor vídeo ya publicado del usuario.

Skills relacionados