¿Qué hace yuv-viral-video?
El pipeline de virales YUV.AI característico. Dos habilidades trabajando juntas:
video-use— transcribe la fuente mediante ElevenLabs Scribe, elige cortes precisos por palabra, extrae y concatena segmentos en unbase.mp4. Esta es la capa de cortes y maquetación base.hyperframes— toma el base como video de fondo y añade la capa de composición visual en HTML/CSS/GSAP: tarjetas de vidrio líquido conbackdrop-filterreal, gráficos animados GSAP con easingback.outelástico, subtítulos karaoke palabra por palabra, transiciones de escena y renderiza a MP4 mediante Chromium.
DEBES usar ambas. No inventes tus propias tarjetas basadas en PIL, no pre-proceses el desenfoque en PNG, no escribas tu propio compositor ffmpeg. La habilidad hyperframes existe específicamente para hacer la capa visual con calidad de Hollywood.
Habilidades complementarias (léelas ANTES de empezar)
Ambas habilidades complementarias están instaladas localmente y son auto-descubiertas por Claude Code al iniciar la sesión. DEBES cargar y aplicar sus directrices — esta habilidad es la capa editorial sobre ellas, no un reemplazo.
| Habilidad | Ruta | Propiedad |
|---|---|---|
video-use | ~/.claude/skills/video-use/SKILL.md (symlink → ~/Developer/video-use) | Transcripción (ElevenLabs Scribe), cortes precisos por palabra, gradación de color, corrección ffmpeg (extracción por segmento → concatenación -c copy, fundidos de audio de 30 ms, superposiciones setpts=PTS-STARTPTS+T/TB, compensaciones SRT de línea de tiempo, caché de transcripción). Lee su sección "Reglas estrictas (corrección de producción — no negociable)" antes de crear edl.json. Los helpers viven en ~/Developer/video-use/helpers/ y se invocan como python helpers/<nombre>.py. |
hyperframes | ~/.claude/skills/hyperframes/SKILL.md | Composiciones de video con HTML como fuente de verdad, atributos de temporización data-*, apariencia controlada por CSS, animación de reloj de biblioteca con precisión de fotograma (GSAP, Lottie, Motion One). Lee sus documentos complementarios house-style.md, data-in-motion.md, patterns.md, visual-styles.md antes de escribir la composición index.html. |
hyperframes-cli | ~/.claude/skills/hyperframes-cli/SKILL.md | Los comandos hyperframes init / lint / preview / render / transcribe / tts. La CLI también está instalada globalmente (hyperframes en $PATH), por lo que npx es opcional. |
gsap | ~/.claude/skills/gsap/SKILL.md | El vocabulario completo de animación GSAP. La regla de easing back.out(1.7) elástica en este documento es un patrón aplicado; recurre al conjunto completo de herramientas de GSAP cuando el material lo requiera. |
website-to-hyperframes | ~/.claude/skills/website-to-hyperframes/SKILL.md | De una sola vez: raspa una URL → composición hyperframes. Útil cuando la fuente tiene interfaz de usuario en pantalla que vale la pena reconfigurar. |
Prioridad (cuando este documento entre en conflicto con una habilidad complementaria)
- Corrección de producción (cortes, codificación, banderas ffmpeg, orden de filtros ffmpeg, manejo de transcripciones) → gana la habilidad complementaria. Si
video-usedice "subtítulos aplicados AL FINAL en la cadena de filtros después de cada superposición" y este documento está en silencio o es diferente, haz lo que digavideo-use. Lo mismo para las convenciones de API de hyperframes, atributosdata-*, patrones de adaptador de fotograma. - Estilo editorial (fuentes, tarjetas de vidrio, "nunca cubrir la cara", versionado
_V<N>, decisiones de diseño de arquetipo, ritmo MrBeast, regla de contenido no fabricado) → gana este documento. Las habilidades complementarias son deliberadamente agnósticas en cuanto a estilo; el estilo de la casa YUV.AI vive aquí. - Confirmación de estrategia: La regla estricta 11 de
video-usedice "confirma el plan en inglés simple antes de ejecutar". Para virales cortos al estilo YUV.AI, esto está deliberadamente suspendido — el estilo está completamente capturado en las Reglas Estrictas de este documento, por lo que el agente debe ejecutar la primera pasada e iterar a partir de los comentarios en lugar de bloquearse con preguntas de dirección creativa. (Para sesiones de video-use no virales, sigue la regla de la habilidad complementaria). - Relleno de borde de corte:
video-usepermite 30–200 ms; este documento elige 50 ms de cabeza / 80 ms de cola como valor predeterminado de YUV.AI dentro de ese rango. Ambos son correctos; el valor más estrecho es una elección de estilo.
Configuración compartida
Ambas habilidades leen ELEVENLABS_API_KEY de ~/Developer/video-use/.env. Configúrala una vez y ambas habilidades funcionarán. No dupliques la clave en el directorio de esta habilidad.
Ubicación de guardado
Predeterminado: ~/Documents/yuv-projects/videos/<slug>/ — guarda siempre los proyectos de video viral aquí para que los renders sean localizables. El <slug> es corto, derivado del tema o del nombre del archivo fuente.
mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# Inicializa el proyecto aquí.
hyperframes init <slug> --video <source.mp4> --non-interactive
cd <slug>
Los renders finales se guardan en ~/Documents/yuv-projects/videos/<slug>/renders/final_*_V<N>.mp4 (tanto 9:16 como 16:9). Informa al usuario dónde están los videos al final de cada render.
Preferencias de estilo (valores predeterminados obligatorios — heredados de yuv-design-system)
Esta habilidad es la instanciación de video del sistema de marca de Yuval Avidani. Siempre que una marca o paleta no esté explícitamente especificada por el contenido fuente, se aplican estos valores predeterminados. Anulan cualquier valor predeterminado conflictivo de las habilidades complementarias.
Tipografía
| Rol | Inglés | Hebreo | Regla |
|---|---|---|---|
| Títulos / tarjetas / subtítulos karaoke | Anton (mayúsculas, peso 400 + tracking apretado -0.02em a -0.04em) | Rubik Black (peso 900) | Siempre mayúsculas para inglés, nunca título. Siempre peso-900 para texto hebreo de título. |
| Cuerpo / texto de tarjeta de vidrio / texto de chip | Inter (400 / 500 / 600 / 700) | Assistant (400 / 500 / 600 / 700) | Usar solo cuando la tarjeta tenga texto de cuerpo secundario debajo del título de visualización. Interlineado 1.4 dentro de las tarjetas. |
| Números / contadores / estadísticas | Anton | Rubik Black | Trata los números como texto de visualización, nunca cuerpo. |
| Código / mono (tarjetas de terminal, rutas) | JetBrains Mono | — | Para revelaciones de código estilo máquina de escribir. |
Dirección hebrea: dir="rtl" en cada contenedor de subtítulos en hebreo. Usa get_display() de python-bidi solo en rutas de respaldo PIL; CSS maneja RTL de forma nativa. Se prefieren las propiedades CSS lógicas (margin-inline-*, padding-inline-*) sobre las físicas (margin-left).
Prohibido: fuentes serif como predeterminadas, pila system-ui, Anton en texto hebreo (se renderiza como X hueca — Anton es solo latino).
Paleta de colores
La paleta canónica de YUV.AI y sus contrapartes ajustadas para video:
| Rol | Web canónica | Renderizada en video (usar dentro del MP4) | Por qué la desviación |
|---|---|---|---|
| Blanco roto / papel | #FAFAF7 | #F5F0E1 (más cálido) | Se lee más cálido sobre fondos oscuros con texto contorneado; reduce el efecto de "deslumbramiento azul-blanco" en H264. |
| Amarillo / acento | #E5FF00 | #FFE61E | Ligeramente más saturado; atraviesa el contorno de texto negro en tamaños pequeños. |
| Rosa / hilo de marca | #FF1464 | #FF1464 | Igual. Usar como acentos de borde de tarjeta de vidrio, trazo de tira de momento clave, hilo de marca. |
| Negro / fondo | #0A0A0A | #0c0e16 (negro cálido) | Evita el banding de negro puro bajo H264. |
| Carbón / texto sobre claro | #1A1A1A | — | Solo superposiciones de interfaz de usuario (páginas de vista previa, nunca dentro del MP4 renderizado). |
| Hueso / crema | #F5EEE4 | — | Páginas web, nunca dentro del MP4. |
Prohibido en cualquier salida renderizada:
#FFFFFFpuro — reemplaza siempre con el blanco roto más cálido.- Acentos azules (azul marino, pizarra, índigo, gris frío) a menos que la marca fuente los requiera.
- Nombres de paleta predeterminados de Tailwind (
slate-*,zinc-*,gray-*,emerald-*,cyan-*,indigo-*,violet-*,rose-*). - Conjuntos de iconos multicolor — solo Phosphor o Lucide de un solo trazo.
Valores predeterminados de diseño y movimiento
- Radio de borde: las tarjetas de vidrio usan
40–56px(redondeado suave característico). Los CTA de píldora999px. Nunca el término medio corporativo redondeado de 8/12px. - Sombras: con tono cálido (subtono rosa/naranja) —
0 20px 60px rgba(255, 20, 100, 0.12)en tarjetas de vidrio, nunca el azul-negro predeterminadorgba(0,0,0,.1). - Espacio en blanco: generoso. Las tarjetas nunca ocupan más del 60% de la zona libre del fotograma.
- Asimetría sobre cuadrícula perfecta. Tarjetas desplazadas. Superposición. Un elemento que rompe la cuadrícula.
- Grano: 1–2% de ruido en cualquier página de vista previa / catálogo (no dentro del MP4 renderizado — se comprimiría a papilla).
- Biblioteca de animación: GSAP (siempre).
back.out(1.7)para entradas de tarjetas,power3.outpara revelaciones SplitText,expo.outpara golpes de ritmo,sine.inOutpara flotaciones inactivas.
Regla de herencia
Si estás construyendo cualquier superficie auxiliar (una página de vista previa, un catálogo, un panel de control, una interfaz de estado de render), aplica los valores predeterminados completos de la habilidad yuv-design-system — tipografía Anton + Inter, paleta púrpura Fly High por defecto, componentes característicos, activos de marca. yuv-design-system es la fuente de verdad canónica para todos los visuales de la marca Yuval.
Si estás renderizando el MP4 en sí, aplica los valores ajustados para video en la tabla anterior. Misma marca, dos superficies de entrega.
El catálogo de efectos en vivo (úsalo como menú)
Yuval mantiene un catálogo visual público, en vivo y desplazable de cada efecto, transición, marcador, tarjeta, tema y SFX que esta habilidad puede aplicar a un video:
Al encargar una edición, Yuval (o cualquier persona a la que envíe el catálogo) hace clic en cualquier chip de efecto — el chip copia un identificador estable como captions.karaoke.scale-pop al portapapeles. Pega esos ID en el prompt:
"edita esto con
style.swiss-pulse, subtítuloskaraoke.scale-pop,marker.circleen estadísticas, transiciónblur-crossfade, sfxwhooshen cada corte, sfximpacten la palabra clave."
Debes respetar cada ID de efecto que el usuario pegue. La página del catálogo es la única fuente de verdad — cada ID se asigna a un efecto documentado con comportamiento verificado. Si el usuario nombra un ID que no reconoces, obtén el catálogo (https://effects.yuv.ai) y encuentra su definición en lugar de improvisar.
El catálogo también contiene una biblioteca de prompts (effects.yuv.ai #prompts) con 8 prompts de edición completos listos para producción (lanzamiento de producto / explicativo / código en vivo / recorrido de flujo / opinión / tutorial / presentación de fundador / entrevista en hebreo). Cuando el usuario se refiera a "el prompt para el escenario X", dirígete allí.
Renderizado bilingüe — Hebreo + Inglés en el mismo video
Muchas ediciones mezclarán narración en hebreo con tokens de marca en inglés (Claude, GitHub, hyperframes, etc.). La habilidad debe:
-
Enrutamiento de fuente por glifo — Anton maneja latín, Rubik Black maneja hebreo. La declaración única
font-family: 'Anton', 'Rubik', sans-serifen cada contenedor de texto hace esto automáticamente. Nunca apliques Anton a un carácter hebreo (se renderiza como una X hueca — Anton es solo latino). -
Contenedores RTL — cada línea de subtítulos en hebreo obtiene
dir="rtl"en su contenedor. Los tokens de marca en inglés permanecen LTR dentro de la misma línea gracias al algoritmo bidireccional del navegador — no es necesario reordenar manualmente. -
Ortografía del nombre de la marca en hebreo — las transliteraciones hebreas preferidas de Yuval:
- "Claude" → "קלוד" (no "קלאוד")
- "Hyperframes" — mantener en inglés ("Hyperframes")
- "GitHub" — mantener en inglés ("GitHub")
- Cuando Scribe transcribe un nombre de marca con la ortografía hebrea incorrecta, corrígelo en la pasada posterior a la transcripción antes de generar la capa karaoke.
-
El catálogo complementario tiene EN/HE bilingüe en todas partes — el catálogo en vivo cambia toda la interfaz de usuario a hebreo con un interruptor (consulta effects.yuv.ai). El mismo patrón de interruptor
data-langse aplica a cualquier superficie auxiliar que produzca esta habilidad (páginas de vista previa, interfaces de estado de render, etc.).
Lecciones aprendidas de iteraciones de producción
Las siguientes se aprendieron en sesiones reales y ahora viven en ~/.claude/skills/yuv-design/lessons-learned.md. Lee ese archivo antes de construir cualquier frontend auxiliar (página de vista previa, panel de render, catálogo). El pipeline de video en sí se rige por las Reglas Estrictas a continuación — pero cualquier superficie HTML/CSS que produzca esta habilidad debe respetar:
- Bilingüe = interruptor, no lado a lado (lección #1 en
lessons-learned.md) - Móvil = navegación de hamburguesa a ≤880px (lección #2)
- Un título principal por sección (lección #3)
document.titlees parte del interruptor de idioma (lección #5)- IntersectionObserver para cualquier catálogo con >8 demos (lección #9)
- Construye completo en la primera pasada — no iteres en el alcance (lección #10)
Claude-in-Chromepara SPA,WebFetchsolo para HTML estático (lecciones #7, #15)- Verifica el contenido de páginas fuente reales, nunca inventes (lección #8)
Cuándo consultar esta habilidad
Cada vez que el usuario suelte un archivo de video y solicite una edición. Incluso una solicitud de una línea como "toma esto y edítalo: " debería desencadenar el flujo completo a continuación. No preguntes por dirección creativa por adelantado — el estilo del usuario está capturado en las Reglas Estrictas a continuación; solo ejecuta e itera a partir de los comentarios.
Tres cosas que internalizar antes de tocar nada
1. NUNCA inventes contenido. Cada palabra en cada tarjeta debe rastrearse hasta algo que el hablante realmente dijo en la transcripción. Sin marcadores de posición de moneda falsos ("$$$"), sin porcentajes falsos ("100% entendido"), sin CTA inventados ("enlace en la bio") si no se prometió ningún enlace. El usuario detectará el contenido fabricado al instante y la confianza se desmorona rápido. En caso de duda, copia la cita hebrea literal en la tarjeta. La misma regla se aplica a la transliteración hebrea de nombres de marca — por ejemplo, cuando una marca es "Claude", la ortografía hebrea adecuada es "קלוד".
2. Prioriza la claridad de la cara del hablante. El rostro del hablante es el activo principal. Cualquier superposición, tarjeta o animación que cubra su cara durante más de 1,5 segundos es inaceptable. Diseña el diseño para que las tarjetas ocupen el tercio inferior o los bordes del marco, dejando el centro del fotograma para el rostro. Si una tarjeta debe cruzar el centro, que sea con opacidad y que desaparezca rápidamente (<0,8 segundos).
3. La velocidad de MrBeast no significa caos. Los cortes son rápidos (cada 2–4 segundos) pero cada transición tiene un propósito: avanzar la narrativa, enfatizar un punto o añadir energía visual. Sin cortes de relleno. Sin transiciones genéricas. Cada fotograma debe hacer avanzar la historia.
Reglas estrictas (corrección de producción — no negociable)
1. Siempre dos relaciones de aspecto
Renderiza SIEMPRE tanto 9:16 (vertical, 1080×1920) como 16:9 (horizontal, 1920×1080). Usa el mismo base.mp4 para ambos — el diseño de hyperframes se ajusta en función de la relación de aspecto.
La composición index.html de hyperframes acepta un parámetro de relación de aspecto (data-aspect="9:16" o data-aspect="16:9"). Pásalo correctamente.
2. Versionado con sufijo _V
Cada guardado de render crea un nuevo archivo. Nunca sobrescribas. El primer render es final_<relación>_V1.mp4, el segundo final_<relación>_V2.mp4, etc. Usa pathlib o el módulo os de Python para encontrar el siguiente número V disponible.
3. Sin marcas de agua ni superposiciones de depuración
Sin bordes rojos. Sin contornos de caja. Sin outline: 2px solid red en ningún lado. Sin console.log en la salida renderizada. Sin superposiciones de tiempo de depuración. Sin indicadores de carga. Sin contadores de fotogramas.
4. Sin contenido falso
Cada pieza de texto en la salida final debe provenir directamente de la transcripción del metraje. Sin citas inventadas. Sin estadísticas inventadas. Sin CTA inventados. Sin marcadores de posición genéricos.
5. Las tarjetas de vidrio deben usar backdrop-filter real
tarjeta {
background: rgba(12, 14, 22, 0.6);
backdrop-filter: blur(20px) saturate(1.2);
-webkit-backdrop-filter: blur(20px) saturate(1.2);
border: 1px solid rgba(255, 255, 255, 0.08);
border-radius: 48px;
}
Sin imágenes de desenfoque pre-renderizadas. Sin filter: blur() falso en un elemento pseudo. Sin fondos de color sólido con opacidad falsa. Sin valores de desenfoque px arbitrarios que no coincidan con la escala visual prevista.
6. Sin blue accent, sin grises predeterminados de Tailwind
La paleta YUV.AI prohíbe azul marino, pizarra, índigo, gris frío. Usa los valores de la tabla de paleta de colores anterior. Sin text-slate-500, bg-gray-100, border-indigo-500. Sin #3B82F6 (azul Tailwind por defecto).
7. Los subtítulos karaoke deben sincronizarse a nivel de palabra
La capa karaoke (de hyperframes) necesita marcas de tiempo por palabra. La pasada de transcripción (video-use) produce Scribe que emite estas marcas. Cada palabra en la línea de subtítulos debe resaltarse en el momento exacto en que se pronuncia. Sin retrasos. Sin resaltado prematuro. Sin fundido de palabras completo.
8. Sin recorte de audio de 0 ms en los segmentos
Cada segmento de corte comienza con un fundido de entrada de 30 ms y termina con un fundido de salida de 30 ms. Sin clics. Sin cortes abruptos. Sin superposiciones de audio. Sin huecos de silencio entre segmentos.
9. Los directorios de proyecto deben tener slug
El slug se deriva del nombre del archivo fuente o del tema: mi-video-genial, no mi video genial (final). Sin espacios. Sin paréntesis. Sin mayúsculas. Guiones entre palabras.
10. El catálogo de efectos es la única fuente de verdad para los parámetros de efectos
Cuando el usuario pega IDs de efectos, debes:
- Reconocer cada ID
- Saber qué hace (consultando el catálogo si es necesario)
- Aplicarlo exactamente como está documentado
- No improvisar parámetros de efectos
- Si un ID no está documentado, obtén el catálogo en vivo para verificar, no adivines
11. Siempre informar las rutas finales
Al final de cada render, muestra al usuario:
~/Documents/yuv-projects/videos/<slug>/renders/final_9:16_V<N>.mp4~/Documents/yuv-projects/videos/<slug>/renders/final_16:9_V<N>.mp4- "¿Quieres verlo o hacer cambios?"
12. Los márgenes izquierdo/derecho en 9:16 deben respetar la cara
Cuando adaptes 16:9 a 9:16, el centro del fotograma (donde está la cara) debe permanecer visible. Sin recortes de cara. Sin composiciones con la cara en el borde del fotograma.
Flujo de trabajo de referencia
Paso 1: Entrada del usuario
El usuario suelta un archivo y dice "edita esto" o equivalente. Reconoce la solicitud y procede.
Paso 2: Inicialización
# Crear directorio del proyecto
mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# Inicializar el proyecto hyperframes
hyperframes init <slug> --video <ruta/al/original.mp4> --non-interactive
cd <slug>
Paso 3: Transcripción y cortes (video-use)
- Ejecuta la transcripción (
python helpers/transcribe.py <video>) - Revisa la transcripción y selecciona cortes
- Genera
edl.jsoncon cortes a nivel de palabra - Extrae segmentos y concatena en
base.mp4 - Verifica que
base.mp4se reproduzca correctamente
Paso 4: Composición visual (hyperframes)
- Crea
index.htmlcon atributosdata-* - Diseña tarjetas de vidrio para momentos clave
- Añade subtítulos karaoke
- Aplica efectos del catálogo (si se especifican)
- Renderiza vista previa
Paso 5: Renderizado final
# Renderizar 9:16
hyperframes render --aspect 9:16 --output renders/final_9:16_V1.mp4
# Renderizar 16:9
hyperframes render --aspect 16:9 --output renders/final_16:9_V1.mp4
Paso 6: Entrega
Informa al usuario de las rutas de los archivos y pregunta si desea modificaciones.
Referencia rápida de comandos
| Comando | Propósito |
|---|---|
hyperframes init <slug> --video <fuente> | Crear nuevo proyecto |
hyperframes render --aspect 9:16 | Renderizar vertical |
hyperframes render --aspect 16:9 | Renderizar horizontal |
hyperframes preview | Vista previa en navegador |
hyperframes lint | Verificar composición |
python helpers/transcribe.py <video> | Transcribir video |
Esta habilidad es parte del ecosistema YUV.AI. Para preguntas o informes de errores, contacta a Yuval.