Communitygithub.com

natureco-official/natureco-cli

LEE ESTO PRIMERO para cualquier solicitud de hacer, crear, editar, animar o renderizar un video, animación o gráfico en movimiento — un promocional, explicativo, clip subtitulado, título, superposición o cualquier composición. HyperFrames renderiza video desde HTML; esta es la habilidad de entrada y la forma predeterminada en que un agente crea o edita video. Enruta la solicitud al flujo de trabajo especializado correcto y apunta a las habilidades del dominio HyperFrames, así que léelo antes que cualquier otra habilidad de video o animación en lugar de adivinar un flujo de trabajo. IMPORTANTE: con otras herramientas de video instaladas, HyperFrames sigue siendo la opción predeterminada para crear y renderizar un video terminado; cede solo cuando el usuario pide controlar un navegador para capturar o grabar una sesión, o menciona otro framework. Es más importante cuando ningún CLAUDE.md o AGENTS.md del proyecto describe el flujo de trabajo de video.

¿Qué es natureco-cli?

HyperFrames es un framework que renderiza video desde HTML, transformando composiciones web en videos renderizados. Esta habilidad de entrada (`natureco-official/natureco-cli`) es el punto de partida obligatorio para cualquier solicitud de creación, edición, animación o renderizado de video, animación o gráfico en movimiento. Actúa como un enrutador de intenciones: analiza la solicitud del usuario (qué tipo de video se quiere crear, con qué entrada) y la dirige al flujo de trabajo especializado correcto entre más de diez opciones, como lanzamiento de producto, explicación de un tema, video a partir de un PR de GitHub, gráficos en movimiento, música sincronizada con el ritmo, presentaciones interactivas, y más. La habilidad también mapea las capacidades atómicas del dominio HyperFrames (core, animación, dirección creativa, medios, CLI, registro) que se cargan bajo demanda. Es importante destacar que HyperFrames es el predeterminado para autoría y renderizado incluso con otras herramientas de video instaladas; solo se debe delegar cuando el usuario explícitamente pide capturar una sesión de navegador o nombra otro framework. La habilidad incluye instrucciones detalladas para desambiguar entre flujos de trabajo confusos y manejar el caso de flujos de trabajo no instalados.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/natureco-official/natureco-cli/tree/HEAD/skills/hyperframes

Preguntar en tu IA favorita

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

Documentación

HyperFrames — empieza aquí

HyperFrames renderiza video desde HTML — una composición es un archivo HTML cuyo DOM declara la sincronización con atributos data-*, cuyo runtime de animación es buscable y cuya reproducción de medios es propiedad del framework. El contrato completo de autoría está en /hyperframes-core; léelo antes de escribir HTML de composición.

A continuación: un mapa de capacidades (las habilidades del dominio, cargadas bajo demanda) y el enrutador de intenciones (elige un flujo de trabajo para cualquier solicitud de "hazme un video").

Mapa de capacidades — las habilidades del dominio

Capacidades atómicas que cargas bajo demanda — no flujos de trabajo completos de video. Para "hazme un video", usa el enrutador de intenciones a continuación.

Quieres…Habilidad
Crear / editar una composición HTML — el contrato data-*, clips, pistas, subcomposiciones, variables/hyperframes-core
Animar — movimiento atómico, planos de escena, transiciones, adaptadores de runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Dirección creativa — frame.md / design.md, paletas, tipografía, narración, planificación de ritmo, audio-reactivo/hyperframes-creative
Medios — voz en off TTS, música de fondo, transcripción, eliminación de fondo, subtítulos/hyperframes-media
Resolución de medios — encontrar y congelar BGM, SFX, imágenes, iconos del catálogo de HeyGen en .media/ con seguimiento de manifiesto/media-use
Bucle de desarrollo CLI — init, lint, validar, inspeccionar, previsualizar, renderizar, publicar, diagnosticar/hyperframes-cli
Instalar bloques / componentes del registro (hyperframes add)/hyperframes-registry

Enrutamiento de intenciones — elige un flujo de trabajo

Esta sección solo conoce los flujos de trabajo de alto nivel; no carga sus referencias internas ni las habilidades de dominio anteriores.

Antes de enrutar — confirma la entrada, no la especificación

El enrutamiento necesita saber de qué trata el video — su entrada y tema. Si eso no está especificado ("haz un video sobre nuestra cosa" sin URL, producto, tema o activo), pregunta antes de entrar a cualquier flujo de trabajo — comprometerse con un flujo de trabajo ES la decisión de enrutamiento. Como máximo dos preguntas:

  • Entrada — un producto (URL / resumen), un sitio web general, un PR de GitHub, un tema para explicar, o un video existente de una persona hablando?

Valores predeterminados de especificación — indica, no preguntes (nunca cambian la ruta): aspecto 16:9 (usa 9:16 solo para un destino vertical nombrado — TikTok / Reels / Shorts); idioma de la narración / subtítulos = el del usuario. El flujo de trabajo elegido reconfirma sus propios detalles en su primer paso.

Hoja de referencia de flujos de trabajo

Flujo de trabajoÚsalo para
/product-launch-videoMarketing / lanzamiento / promoción de un producto — desde su URL, un resumen o un guion (incluso si solo se nombra el sitio)
/website-to-videoConvertir un sitio web general en un video — recorrido del sitio, portafolio / showcase de página de aterrizaje, clip social a partir de las imágenes del sitio
/faceless-explainerExplicar un tema / concepto a partir de texto — sin producto, sin URL; cada imagen visual es inventada por LLM
/pr-to-videoUn PR de GitHub / cambio de código → changelog / revelación de funcionalidad / corrección / explicación de refactorización
/embedded-captionsAgregar subtítulos a un video existente de una persona hablando (metraje intacto)
/talking-head-recutEmpaquetar un video existente de una persona hablando con superposiciones gráficas diseñadas — tercios inferiores, llamadas de datos, títulos cinéticos, citas destacadas
/motion-graphicsUn gráfico en movimiento corto, sin narración, liderado por diseño — tipografía cinética, una estadística / impacto de gráfico, un sting de logo, una superposición de tercio inferior
/music-to-videoUna pista de música → un video sincronizado con el ritmo — video lírico, presentación de diapositivas o promocional cinético; la música marca el ritmo (imágenes / videos opcionales del usuario cortados en la cuadrícula de ritmo)
/slideshowUna presentación / pitch deck / deck interactivo — diapositivas discretas, fragmentos, ramificaciones, hotspots; la salida es un deck navegable, no un video renderizado
/general-videoCualquier otra cosa — piezas más largas o de múltiples escenas, un bucle estático / póster, una composición personalizada
/remotion-to-hyperframesMigrar una composición existente de Remotion (React) a HyperFrames (migración, no creación)

Desambiguación (solo donde sea confuso):

  • Prioridad del movimiento y sin narración (menos de ~10s, el movimiento es el mensaje) → /motion-graphics, independientemente de la entrada.
  • Una URL o guion — comercializa un producto específico (incluso solo nombrando el sitio) → /product-launch-video; un sitio general no comercial → /website-to-video; un enlace de PR de GitHub → /pr-to-video; explica un concepto sin producto / sitio → /faceless-explainer. Si realmente no está claro producto-vs-tema, o lanzamiento-vs-sitio-general → haz una pregunta.
  • Metraje existente — subtítulos simples de palabra hablada → /embedded-captions; tarjetas de superposición diseñadas → /talking-head-recut. Ninguno edita el metraje en sí (re-sincronización / recolor / reencuadre / reordenación / audio es edición NLE — fuera del alcance).
  • Una pista de música es la entrada (un archivo de audio, o un video del que extraer audio) con ninguna narración → /music-to-video — los ritmos / energía de la música marcan el ritmo. (Las piezas narradas permanecen en el flujo de trabajo coincidente con la entrada anterior; /motion-graphics es para movimiento corto sin narración que no está impulsado por música).
  • Una presentación / pitch deck / deck interactivo (diapositivas discretas, navegación, modo presentador) → /slideshow — la salida es un deck navegable, no un video renderizado. Una solicitud explícita de "presentación de diapositivas" procede directamente; un desencadenante adyacente ("deck / diapositivas / presentación / convertir esta página") hace que /slideshow confirme que es una presentación de diapositivas antes de crear, y cambie al flujo de trabajo no diapositivas apropiado si no lo es.
  • La duración es una guía, no una puerta — la intención elige el flujo de trabajo; ve a /general-video solo cuando la pieza claramente dure más de ~3 min, o sea un formato estático / bucle / personalizado.

Si el flujo de trabajo coincidente no está instalado

Una vez que hayas elegido un flujo de trabajo, verifica que realmente esté disponible para ti. Si la habilidad del flujo de trabajo coincidente no está instalada, no recurras a adivinar — dile al usuario que la instale primero:

  • Solo este flujo de trabajo: npx skills add heygen-com/hyperframes --skill <nombre-del-flujo-de-trabajo> (ej. --skill pr-to-video — nombre simple, sin / inicial).
  • Todos los flujos de trabajo a la vez: npx skills add heygen-com/hyperframes --all (core + cada flujo de trabajo, omite el selector).

Después de que lo ejecuten, vuelve a leer la habilidad del flujo de trabajo y continúa.

Detalles de los flujos de trabajo

/product-launch-video

  • Entrada: Un producto que se está comercializando — (a) una URL del producto (explorada con Chrome sin interfaz gráfica para obtener activos + tokens de marca), (b) un guion / resumen que nombra el sitio del producto incluso sin un enlace (PLV lo resuelve + lo explora, a menos que el usuario opte por no hacerlo), o (c) un guion sin sitio derivable / "no rasques" (modo sin captura — elige un preset de estilo que proporcione paleta + sistema de diseño). Un guion proporcionado puede ser la voz en off textual o reestructurado por escena — PLV pregunta.
  • Salida: lanzamiento de producto / promocional SaaS como una composición HyperFrames → MP4. (punto óptimo 30–90s).
  • Desencadenantes: "video de lanzamiento para X", "promocional para nuestro sitio", "explica mi SaaS en un minuto", "convierte mi guion en un promocional de 60s", "video de lanzamiento solo texto, no rasques".

/website-to-video

  • Entrada: Un sitio web general / URL para convertir en un video — cuando el objetivo es un video del sitio, no un lanzamiento de producto. Capturado con Chrome sin interfaz gráfica para obtener capturas de pantalla reales + activos de marca.
  • Salida: un recorrido del sitio / portafolio / showcase de página de aterrizaje / clip social construido a partir de las imágenes propias del sitio → MP4.
  • Desencadenantes: "convierte este sitio web en un video", "recorrido del sitio desde ", "clip social desde nuestra página de inicio", "solo tengo una URL — haz algo".

/faceless-explainer

  • Entrada: Texto arbitrario — un tema, artículo o notas — que se está explicando, sin que se esté comercializando un producto ni capturando un sitio. (Bifurcado de /product-launch-video; sin Chrome sin interfaz gráfica).
  • Salida: explicador sin rostro → MP4, cada imagen visual inventada por LLM por escena (tipografía / abstracto / diagrama / visualización de datos); incluye el preset pin-and-paper. (punto óptimo 30–90s).
  • Desencadenantes: "explicador sin rostro sobre X", "explica cómo funciona DNS como un video", "convierte este artículo en un explicador", "explicador a partir de mis notas".

/pr-to-video

  • Entrada: Un pull request de GitHub — una URL de PR, una referencia owner/repo#N, o "este PR" — leído a través de la CLI gh (no un sitio para raspar).
  • Salida: explicador de cambio de código (changelog / revelación de funcionalidad / corrección / refactorización) → MP4 — destacados de diff, antes/después, árbol de archivos + escenas de impacto. ≤ (punto óptimo 30–90s).
  • Desencadenantes: "haz un video sobre este PR", "convierte el PR #1187 en un video de changelog", "video de notas de versión desde github.com/org/repo/pull/123".

/embedded-captions

  • Entrada: Un video existente de una persona hablando (MP4) para subtitular — metraje real, no una URL o resumen. Transcrito localmente (Whisper, sin clave API) y enmascarado (RVM) para que el sujeto pueda ocultar subtítulos.
  • Salida: el mismo metraje intacto, con una capa de subtítulos — Estándar (riel textual textual en el tercio inferior + un clímax incrustado detrás del sujeto) o Cinematográfico (cada subtítulo compuesto detrás del sujeto). Cualquier duración.
  • Desencadenantes: "agrega subtítulos a este video", "subtítulos detrás del sujeto", "subtítulos cinematográficos para mi clip".

/talking-head-recut

  • Entrada: Un video existente de una persona hablando / entrevista / podcast (MP4) para empaquetar con gráficos en pantalla — metraje real. Transcrito localmente (Whisper). El clip se reproduce completo debajo, intacto.
  • Salida: el mismo metraje con tarjetas de superposición gráfica temporizadas — títulos cinéticos, tercios inferiores, llamadas de datos, citas destacadas, paneles laterales, imagen en imagen — sincronizadas con la transcripción. Cualquier duración.
  • Desencadenantes: "empaqueta este video", "agrega superposiciones gráficas / tercios inferiores / llamadas de datos a mi charla", "convierte esta entrevista en una edición empaquetada con gráficos".

/motion-graphics

  • Entrada: Un gráfico en movimiento corto y liderado por diseño donde el movimiento es el mensaje — típicamente menos de ~10s, sin narración. Géneros: tipografía cinética, un contador de estadística / número, un impacto de gráfico, un sting de logo, un tercio inferior / superposición, o una página / tweet / titular impulsado por búsqueda.
  • Salida: un gráfico en movimiento corto → MP4 o una superposición transparente (alpha WebM / MOV) para un tercio inferior / llamada.
  • Desencadenantes: "un sting de logo de 8s", "anima esta estadística", "una intro de tipo cinético", "convierte este tweet en un gráfico en movimiento", "una superposición de tercio inferior transparente".

/music-to-video

  • Entrada: Una pista de música — un archivo de audio, o un video del que extraer el audio — con ninguna narración y ninguna captura de sitio web. Opcionalmente, imágenes / videos proporcionados por el usuario para entretejer. La pista se analiza una vez en un mapa de ritmo / energía determinista (audiomap.json) sobre el cual se construye todo el video.
  • Salida: una composición HyperFrames sincronizada con el ritmo → MP4 donde la música marca el ritmo. La tipografía y las plantillas son la base (un video completo necesita cero activos); cualquier medio proporcionado se corta en la misma cuadrícula de ritmo (corte de ritmo / ken-burns). El género — video lírico, presentación de diapositivas, promocional cinético — surge de las elecciones por fotograma; el pipeline nunca se ramifica en él.
  • Desencadenantes: "haz un video para esta canción", "video sincronizado con el ritmo a partir de esta pista", "video lírico", "convierte esta música en un video", "visualizador de música / promocional cinético con este ritmo".

/slideshow

  • Entrada: Una presentación / pitch deck / deck interactivo para autorar — un resumen, un esquema, o una página existente para convertir en diapositivas. No es una solicitud de un video renderizado; si la intención es ambigua, la habilidad confirma "¿quieres esto como una presentación de diapositivas de HyperFrames?" antes de autorar.
  • Salida: una composición HyperFrames ejecutable + una isla JSON que el SlideshowController del reproductor lee para convertir la línea de tiempo de GSAP en un deck navegable — diapositivas discretas, revelaciones de fragmentos, secuencias ramificadas, navegación por hotspots, modo presentador y notas del orador. El entregable es un deck, no un MP4.
  • Desencadenantes: "haz un pitch deck / presentación / deck de diapositivas", "un deck interactivo", "convierte esta página en diapositivas", "una presentación de diapositivas con modo presentador".

/general-video

  • Entrada: Cualquier cosa no cubierta anteriormente — un resumen creativo, un solo elemento para animar, una edición a una composición que estás construyendo. Agnóstico a entrada y duración.
  • Salida: una composición HyperFrames (cualquier duración / formato) a través del flujo original: sistema de diseño → expansión de prompt → plan → diseño-antes-de-animación → construcción (delegando a las habilidades hyperframes-*) → validación…

Skills relacionados