Communitygithub.com

MiguelBai/yanni-video-editor

Edita los videos de Yanni (videos de cabecera hablando) al estilo "paper cut" de reels científicos: su rostro en cámara intercalado con escenas de papel arrugado donde caen objetos recortados, páginas de estudio reales se deslizan, números estadísticos rojos aparecen y subtítulos palabra por palabra recorren todo el video. Úsalo SIEMPRE que el usuario arrastre un archivo de video o diga "edita esto", "edita mi video", "haz el reel", "corta esto", "haz el estilo papel" o /yanni-editor:edit. Cubre todo el trabajo: corte de silencios, transcripción, plan de ritmos, imágenes y capturas de estudio, construcción con HyperFrames, vista previa, renderizado y revisiones.

¿Qué es yanni-video-editor?

Este skill está diseñado para transformar automáticamente videos de cabecera de Yanni (creador de contenido sobre nutrición, péptidos y físico) en reels profesionales de 1080×1920 en el estilo "paper cut". El proceso completo incluye: normalización del video, transcripción con Whisper, detección y eliminación de tomas falsas y silencios, planificación de ritmos alternando entre toma de rostro y escenas de papel arrugado, búsqueda de imágenes reales de estudios y objetos, construcción del proyecto con HyperFrames, y renderizado final. El skill se ejecuta en la terminal con scripts de Node.js y requiere FFmpeg, Whisper CLI y Node instalados. Es útil para creadores que quieren producir contenido educativo/divulgativo de alto impacto visual sin editar manualmente. Soporta iteraciones rápidas: el usuario puede pedir cambios y el skill reconstruye el video. La documentación detalla reglas estrictas como no inventar evidencia, usar un solo color de acento (el de la marca), y mantener los subtítulos fieles a lo dicho.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MiguelBai/yanni-video-editor/tree/HEAD/skills/edit

Preguntar en tu IA favorita

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

Documentación

Editor de reel estilo papel recortado

Yanni es un creador de contenido sobre nutrición, péptidos y físico. Se graba a sí mismo hablando. Este skill convierte la toma original en un reel terminado de 1080×1920 en el estilo del video de referencia que eligió (un explicador de farmacología): su rostro en cámara, intercalado con escenas explicativas de papel arrugado, subtítulos sobre todo.

El usuario apenas usa Claude. Haz todo el trabajo tú mismo, mantén los mensajes cortos y sencillos, y solo detente a preguntar cuando realmente necesites algo de él (un enlace a un estudio, un video faltante). Nunca le muestres JSON sin procesar ni registros largos.

Lee references/style.md una vez antes de tu primer plan. Es la biblia del estilo medido; este archivo es el procedimiento.

E abajo significa <directorio base de este skill>/engine.

0. Verificación previa

  • Si falta ~/.yanni-editor/brand.json, o ffmpeg/whisper-cli/node: ejecuta primero el skill de configuración, luego vuelve.
  • Encuentra el video. Si arrastró un archivo, la ruta está en su mensaje. Si no, pregunta una vez: "Arrastra el archivo de video a esta ventana y pulsa Enter."
  • Carpeta del proyecto: <projectsDir de brand.json>/<tema-en-kebab-case> (por ejemplo ~/Movies/Yanni Edits/bpc-157-healing). Elige el slug después de que la transcripción te dé el tema; usa untitled-<fecha> hasta entonces y renómbralo después.

1. Preparación y transcripción

node "$E/prep.mjs" "<video original>" "<proyecto>"

Normaliza a 1080×1920 30fps a -16 LUFS y escribe build/raw.transcript.txt (frases con marcas de tiempo). Lee ese archivo.

2. Corte de saltos (y tomas malas)

Busca retomas: la misma frase dicha dos veces, un inicio falso, "espera, déjame repetir eso". Conserva la ÚLTIMA toma, elimina las anteriores por rango de tiempo. También elimina basura evidente al principio y al final (como cuando alcanza el teléfono).

node "$E/cut.mjs" "<proyecto>" --remove "3.10-7.85,40.2-44.0"
# sin retomas: node "$E/cut.mjs" "<proyecto>"

Las pausas se cortan del audio en sí (cualquier cosa más silenciosa que -35 dB durante 0.3 s o más). Si suena apurado, usa --gap 0.45; si la habitación es ruidosa y no se corta nada, prueba --db -30. Salida: build/head.mp4 y build/transcript.txt en tiempo cortado. Todos los tiempos de ritmo de aquí en adelante son tiempos cortados.

Lee build/transcript.txt. Whisper se equivoca con los nombres; escribe las correcciones en replace dentro de edit.json (un mapa palabra por palabra, sin distinguir mayúsculas), por ejemplo {"BPC157": "BPC-157", "tren": "Tren"}.

3. Planificar los ritmos (escríbelo antes de tocar los recursos)

Escribe build/plan.md: una fila por ritmo con el rango de tiempo cortado, la línea hablada, FACE o PAPER, y para papel qué se muestra en pantalla. Reglas del video de referencia:

  • Abrir en PAPEL. Los primeros 2 a 4 segundos son una escena de papel con una etiqueta de encabezado negra nombrando el tema y el objeto principal cayendo. Esto es el gancho.
  • El primer ritmo de FACE lleva el sello con nombre ("stamp": 0.2).
  • Alternar. Nunca dos ritmos de papel seguidos sin uno de rostro entre ellos, a menos que el pensamiento hablado claramente continúe (entonces hazlo un solo ritmo de papel con varias tomas). Los ritmos de papel duran de 2 a 5 s, los de rostro de 1.5 a 5 s. Apunta a que el papel ocupe entre el 45 y el 55 por ciento de la duración total. build.mjs imprime paperShare.
  • Qué va en papel: el momento en que nombra un compuesto, alimento, suplemento, parte del cuerpo o estudio; dice un número; describe un mecanismo. Qué se queda en rostro: opiniones, advertencias, conclusiones, chistes, el llamado a la acción. El rostro es la confianza; el papel es la prueba.
  • Dentro de un ritmo de papel, la toma cambia cada 1.2 a 2.5 s. whip a la siguiente página de estudio, push para agregar la estadística o figura debajo de la tarjeta actual, zoom para intercambiar objetos. Un ritmo de papel con una sola toma estática durante 4 s está muerto.
  • Tramo largo de rostro (más de ~4 s con un corte de salto dentro): divídelo en dos ritmos de rostro y dale al segundo "zoom": 1.12 (un acercamiento oculta el corte).

4. Recopilar los elementos visuales

Pon todo en build/assets/. Escribe build/assets/credits.txt con la fuente de cada imagen (find_images imprime licencia y página).

Objetos recortados (vial, jeringa, pechuga de pollo, huevo, mancuerna, cerebro, hígado):

node "$E/find_images.mjs" "jeringa" "<proyecto>/build/cand" --n 6
# MIRA los candidatos (Léelos), elige el objeto más claro sobre fondo liso
node "$E/cutout.mjs" "<proyecto>/build/cand/jeringa-2.jpg" "<proyecto>/build/assets/jeringa.png"

Luego MIRA el recorte. La eliminación de fondo falla en vidrio, plástico transparente y fondos con mucha información. Si falló, prueba otro candidato, o usa la foto como card en lugar de cutout. La anatomía se ve mejor como grabados antiguos: busca "Gray's anatomy <órgano>" y usa "mono": true para el aspecto en escala de grises que usa la referencia. Si él tiene sus propias fotos de producto, prefiere esas.

Páginas de estudio (la columna vertebral de este estilo):

  • Solo estudios REALES. Pídele el enlace si cita uno y no puedes encontrarlo con certeza. Nunca inventes un estudio, una página de revista, una figura o un número. Afirmaciones de salud en una captura de pantalla falsa pueden dañar a personas y su cuenta.
  • Captura de pantalla a través de Europe PMC (PubMed bloquea navegadores sin interfaz gráfica):
    node "$E/webshot.mjs" "https://europepmc.org/article/MED/<PMID>" "<proyecto>/build/cand/study.png"
    
    MÍRALO. Luego recorta la parte de la que está hablando: el bloque de título para "un estudio de 2017 de Oslo...", la oración de resultados exacta o figura para la afirmación:
    ffmpeg -v error -y -i study.png -vf "crop=W:H:X:Y" -frames:v 1 "<proyecto>/build/assets/study-title.png"
    
    La captura está a escala 2x, por lo que los recortes son nítidos. Mantén las tarjetas legibles: recorta apretado, una tarjeta tiene como máximo ~820 px de ancho en pantalla.
  • Las páginas de revistas (ScienceDirect, Wiley) a menudo también bloquean. Si la captura es un captcha o está en blanco, pídele que capture la página en su Mac (Cmd+Mayús+4) y arrastre el archivo.

Números estadísticos (stat): solo números que dice en voz alta, palabra por palabra.

5. Escribir build/edit.json y construir

Formato completo y todas las opciones: references/edit-json.md. Forma mínima:

{
  "title": "bpc-157 healing",
  "video": "head.mp4",
  "transcript": "transcript.json",
  "replace": { "bpc157": "BPC-157" },
  "beats": [
    { "type": "paper", "start": 0, "end": 3.2, "header": "¿Cura el BPC-157 los tendones?",
      "shots": [
        { "at": 0, "enter": "drop", "items": [ { "kind": "cutout", "src": "assets/vial.png", "label": "BPC-157" } ] },
        { "at": 1.6, "enter": "zoom", "items": [ { "kind": "cutout", "src": "assets/tendon.png", "mono": true } ] }
      ] },
    { "type": "face", "start": 3.2, "end": 6.4, "stamp": 0.2 },
    { "type": "paper", "start": 6.4, "end": 10.1,
      "shots": [
        { "at": 0, "enter": "cut", "items": [ { "kind": "card", "src": "assets/study-title.png" } ] },
        { "at": 1.8, "enter": "push", "items": [ { "kind": "stat", "text": "40 ratas", "enter": "pop" } ] },
        { "at": 2.7, "enter": "whip", "items": [ { "kind": "card", "src": "assets/study-result.png" } ] }
      ] }
  ]
}

Cualquier cosa no cubierta por un ritmo de papel muestra su rostro. Luego:

node "$E/build.mjs" "<proyecto>/build/edit.json"
cd "<proyecto>/build" && npx -y hyperframes@latest check

check debe decir Check passed. Las advertencias sobre subcomposiciones, densidad de pistas e imágenes duplicadas son esperadas para este formato; los errores no.

6. Revisar antes de mostrárselo

cd "<proyecto>/build" && npx -y hyperframes@latest snapshot --at <un tiempo dentro de cada ritmo>

Lee snapshots/contact-sheet-*.jpg. Verifica: cada ritmo de papel tiene algo encima, nada se superpone a los subtítulos, las tarjetas son legibles, los recortes tienen bordes limpios, el sello está en su primer ritmo de rostro, los subtítulos están bien escritos. Corrige y reconstruye hasta que esté bien. Él nunca debe ser quien encuentre un fotograma roto.

7. Vista previa y renderizado

Renderiza un borrador para que pueda verlo en su teléfono o Mac:

cd "<proyecto>/build" && npx -y hyperframes@latest render --quality draft --output "../out/<slug>-draft.mp4"
open "<proyecto>/out"

Dile en dos líneas: dónde está el archivo, y "dime cualquier cosa que quieras cambiar, como 'haz el estudio en 0:12 más grande' o 'más rostro en el medio'."

Para cambios: edita build/edit.json, reconstruye, verifica, captura instantánea, re-renderiza. Para la versión final:

npx -y hyperframes@latest render --quality high --output "../out/<slug>.mp4"

Verifica que el archivo exista, se reproduzca y su duración coincida con build/head.mp4 (ffprobe -v error -show_entries format=duration -of csv=p=0 <archivo>). Si supera ~60 MB, re-codifica para subir: ffmpeg -i in.mp4 -c:v libx264 -crf 21 -preset slow -c:a copy out.mp4.

Si quiere hacer ajustes manuales, npx -y hyperframes@latest preview en la carpeta build abre HyperFrames Studio en el navegador con la línea de tiempo completa.

Reglas estrictas

  1. Nunca fabriques evidencia. No inventes estudios, números, figuras, citas o imágenes de antes/después. Si el audio afirma algo que no puedes respaldar, mantén esa línea en su rostro y dile qué línea necesita una fuente.
  2. Los subtítulos coinciden con lo que DIJO, no con lo que decía el guión. Corrige solo la ortografía.
  3. Un solo color de acento, de brand.json. Texto de estadísticas en rojo, línea del sello en rojo, nada más coloreado excepto las imágenes mismas.
  4. No cambies el estilo del sistema por video. Las fuentes, el papel, el aspecto de los subtítulos y el movimiento viven en engine/runtime/. Un video tiene su propio edit.json, nunca su propio CSS. Si pide un cambio de estilo global, cambia el runtime una vez.
  5. El tiempo es tiempo cortado, de build/transcript.txt, nunca tiempo original.

Individual skills in this repo

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

Skills relacionados