Communitygithub.com

octaviosilva2/frontend-video-skill

Produce un vídeo determinístico con HyperFrames: composición HTML/CSS capturada en Chrome/FFmpeg, con formato, fps, duración y resolución declarados, y render autorizado. Úsalo cuando la entrega es un archivo de medios renderizado (MP4, WebM, MOV, PNG), cuando el usuario solicita una pieza de video, animación exportada o composición reproducible. No usar para video ya existente incrustado en un sitio web (eso es un activo web común) ni para UI animada interactiva.

¿Qué es frontend-video-skill?

Esta skill permite generar videos determinísticos a partir de composiciones HTML/CSS, capturándolas con Chrome y FFmpeg. Es ideal cuando el resultado final debe ser un archivo de medios renderizado (MP4, WebM, MOV, PNG) en lugar de contenido interactivo o un activo web común. La skill impone reglas estrictas para evitar usos inapropiados: no se activa para videos incrustados en sitios web ni para animaciones de interfaz interactivas. Además, exige que el usuario defina explícitamente formato, resolución, fps y duración, y nunca ejecuta un render sin autorización previa, ya que consume recursos de máquina y puede generar costos. La reproducibilidad byte a byte requiere fijar versiones de HyperFrames, Chrome, FFmpeg, fuentes, activos, codec, flags, resolución, fps, duración y entorno.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add octaviosilva2/frontend-video-skill

Preguntar en tu IA favorita

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

Documentación

El gate — antes de cualquier composición

Gatillo literal: la entrega ES un archivo de medios renderizado. MP4, WebM, MOV, PNG. Formato de la entrega, nunca apariencia.

No activa esta skill:

  • Video usado dentro de un sitio web — hero, background, testimonio. Eso es un activo web común, tratado como cualquier imagen o fuente (ver referencias/assets.md).
  • Pieza de UI animada que "parece video" pero es interactiva — es motion o 3D de interfaz, no render.

La distinción es de formato de la entrega. Si el resultado se abre en el navegador y responde a clics, no es esta skill.

Formato, resolución, fps y duración no tienen valor por defecto

Elegir "1080p 30fps porque es común" es exactamente lo que el gate existe para impedir. Los cuatro campos — formato, resolución, fps y duración — suben al usuario antes de que la composición comience.

Costo operativo — confirma antes de comprometer

HyperFrames no es un import: es un proceso de producción. Depende de Chrome y FFmpeg instalados, y la captura puede distribuirse.

Confirma que la infraestructura existe antes de prometer la ruta. Descubrir en el momento del render que falta FFmpeg es descubrir después de que la composición entera esté escrita.

Render nunca es automático

Ninguna ejecución de render ocurre sin autorización explícita del usuario. Render consume tiempo de máquina y, cuando hay generación de medios involucrada, dinero real.

Cuando falte un activo y la alternativa sea generarlo: nombra lo que falta y lo que generaría — y detente ahí.

Cómo usar

frontend-video/
├── SKILL.md                ← este archivo. El ÚNICO siempre leído
└── referencias/
    ├── hyperframes.md      el gate, formato/fps/duración, tiempo determinístico,
    │                       adapters, captions, autorización de render
    ├── direcao-visual.md   tokens con razón escrita, anti-genérico
    ├── assets.md           origen, licencia, optimización — aquí el activo ES la entrega
    └── validacao.md        los gates aplicables a los medios
Tu tareaAbre
decidir formato, resolución, fps, duraciónhyperframes.md §3
contenido, fuentes, captions, derechoshyperframes.md §4
tiempo determinístico, salida reproducible, adaptadores de escenahyperframes.md §5
accesibilidad y rendimiento de la piezahyperframes.md §6
autorizar el renderhyperframes.md §7
dirección estética de la composicióndirecao-visual.md
licencia de imagen, fuente, pistaassets.md
cerrar la entregavalidacao.md

Siempre ignorar: SEO, DOM indexable, recorrido de navegación y estados de aplicación — los medios determinísticos no tienen ninguno de los cuatro. Runtime web como entrega final tampoco se aplica: aquí el navegador es herramienta de captura, no el destino.

Reproducibilidad — lo que "determinístico" realmente exige

El engine vuelve la composición buscable por tiempo. Esto solo no garantiza salida idéntica.

Prometer un archivo reproducible byte a byte exige fijar todo esto: HyperFrames, Chrome, FFmpeg, fuentes, activos, codec y flags, resolución, fps, duración y entorno. Un mismo commit sin ese bloqueo no autoriza la promesa.

Fuente auditada: repositorio heygen-com/hyperframes, commit af1cb1c10da33bade100db8233435c7591b7c0bc, paquetes principales 0.8.17 en ese commit, licencia Apache-2.0 en la raíz y en el CLI. Verificado en 2026-08-28. Reauditar si la versión cambia o si la composición depende de capacidad no cubierta por las fichas.

Lo que siempre aplica

  1. Contenido real, nunca inventado — sin placeholder que parezca final.
  2. Captions y contraste son parte de la entrega, no un extra.
  3. Validación en el output real, nunca en el preview. Lo que el preview muestra y lo que el archivo final contiene divergen — codec, color y timing entre ellos.
  4. El código de escena autoral sigue siendo responsable de su propio disposal. Una escena Three/WebGL dentro de la composición necesita teardown como en cualquier otro lugar.

Skills relacionados