Instalación de plugins: Antes de los comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización a continuación.
Punto de entrada de HyperFrames
Verificar uso restante
Al inicio de la creación, ejecuta npx hyperframes usage --json. Vuelve a verificarlo en hitos del flujo de trabajo, como después del borrador y antes del renderizado, porque el uso cambia durante la ejecución. Lee las ventanas disponibles y sus tiempos de reinicio; una lectura previa no reserva asignación. Si el comando falla, no está disponible o devuelve status: unknown, informa que el uso es desconocido y no lo adivines. Mantén el alcance y las opciones de flujo de trabajo con el usuario.
HyperFrames renderiza video desde HTML — una composición es un archivo HTML cuyo DOM declara la sincronización con atributos data-*, cuyo tiempo de ejecución de animación es buscable, y cuya reproducción de medios es controlada por el marco de trabajo. El contrato completo de autoría está en /hyperframes-core; léelo antes de escribir HTML de composición. Los contratos de brief, storyboard, revisión, producción, envío y frame-worker viven en references/ de este skill.
1. Comenzar desde el estado del proyecto
Aplica la primera fila que coincida; no evalúes filas de estado inferiores:
| Estado | Acción |
|---|---|
| Puerto explícito de una fuente Remotion existente a HyperFrames | Lee references/routes/remotion-to-hyperframes.md, luego enruta directamente a ese flujo de trabajo. Omite la capa de intención. |
| Operación específica en un proyecto HyperFrames existente: inspeccionar, diagnosticar, validar, previsualizar, renderizar, publicar o renderizar por lotes | Realiza solo esa operación. Omite el enrutamiento de intención y flujo de trabajo; carga /hyperframes-cli y cualquier skill de dominio requerido. |
| Una pregunta, una pausa, una idea sin cambio concreto, o una nota sobre una película ya construida, en un proyecto existente | Sigue /hyperframes-studio § 0. |
| Una nueva película solicitada dentro de un proyecto existente | Sigue /hyperframes-studio § 5. |
| Edición específica a un proyecto existente | Realiza la edición. No ejecutes la capa de intención. Para saber qué hay en la línea de tiempo de un proyecto (pistas, clips, inicios, finales, qué se reproduce), ejecuta npx hyperframes timeline [--json] en lugar de leer index.html y cada archivo de subcomposición. |
Existe BRIEF.md | Lee workflow y flow. Ejecuta ese flujo de trabajo; flow: companion siempre se ejecuta en /general-video. No hagas preguntas sobre el brief. |
Sin brief, pero existen hyperframes.json o STORYBOARD.md | Reanuda desde los archivos del proyecto y las preferencias registradas. Infiere el flujo de trabajo propietario a partir de los artefactos existentes. Si no se puede determinar de manera única, haz una sola pregunta de enrutamiento; no ejecutes la entrevista de intención. |
| Creación desde cero | Ejecuta la capa de intención — references/intent-interview.md — luego enruta una vez usando la tabla de la § 2. |
Cuando edites un proyecto existente, delimita tus ediciones con el historial del proyecto (/hyperframes-cli, historial del proyecto en tu turno).
Si una solicitud nueva no identifica el tema o la entrada, pregunta de qué trata el video antes de enrutar. Verifica preferencias y recetas antes de preguntar cualquier cosa (references/intent-interview.md, paso 1). Una entrada de figma.com o una receta nombrada cambia la toma, no el enrutamiento — la sección "Adaptar entradas ortogonales" de la entrevista maneja ambas.
Mantener actualizado el CLI del proyecto
Un proyecto scaffolded fija hyperframes@<versión> en sus scripts de package.json para que los renderizados sean reproducibles; la fijación nunca avanza por sí sola, y una ejecución fijada de un CLI antiguo no imprime ninguna advertencia al respecto. Al reanudar un proyecto cuyos scripts llevan una fijación, verifica una vez antes del primer comando que afecte al renderizado:
npx hyperframes@latest upgrade --project . --check
La verificación es de solo lectura e informa la fijación contra la última versión; mantén el . explícito — en versiones antiguas del CLI, un --project sin argumentos seguido de otra bandera consume esa bandera como su valor de directorio. Cuando informa que el proyecto está desactualizado — o cualquier salida del CLI ya lo muestra (el aviso de stderr Este proyecto fija hyperframes@… (último …), o _meta.updateAvailable: true en un resultado --json de un script fijado) — aplica con npx hyperframes@latest upgrade --project ., luego verifica con npx hyperframes check. Una verificación exitosa confirma que las composiciones del proyecto aún se validan en la nueva versión — no que la salida renderizada sea idéntica cuadro a cuadro a la fijación anterior — por lo que un incremento exitoso nunca es silencioso: nombra la versión anterior y la nueva en el resumen de la ejecución. Un proyecto sin composición aún no necesita verificación. Si la verificación falla, revierte el cambio en package.json, continúa con la versión fijada, e informa en qué versión se mantiene el proyecto y por qué. Actúa sobre la señal en lugar de transmitirla al usuario; nunca dejes una fijación incrementada sin verificar.
2. Enrutar creación desde cero
Usa la primera fila que coincida. Coincide con el entregable solicitado, no con una palabra o tipo de archivo mencionado de pasada.
| Prioridad | Solicitud | Flujo de trabajo |
|---|---|---|
| 1 | Puerto explícito de una fuente Remotion existente | /remotion-to-hyperframes |
| 2 | Crear una presentación, pitch deck o deck interactivo navegable | /slideshow |
| 3 | Añadir subtítulos simples o subtítulos a material de cabezas parlantes existente sin cambiarlo | /embedded-captions |
| 4 | Añadir superposiciones gráficas diseñadas a material de cabezas parlantes, entrevistas o podcasts existente sin cambiar el material | /talking-head-recut |
| 5 | Construir un video sincronizado con el ritmo a partir de una pista musical, sin narración ni captura de sitio web | /music-to-video |
| 6 | Crear una unidad explícitamente corta, sin narración, centrada en el movimiento, típicamente de menos de 10s | /motion-graphics |
| 7 | Explicar una solicitud de extracción de GitHub o un cambio de código a partir de una referencia de PR | /pr-to-video |
| 8 | Comercializar o mostrar un sitio web, sitio de producto, aplicación o empresa a partir de una URL o brief específico del sitio | /product-launch-video |
| 9 | Explicar un tema, artículo o notas con imágenes inventadas y sin captura de producto o sitio | /faceless-explainer |
| 10 | Cualquier otro video o composición personalizada | /general-video |
Antes de finalizar la ruta, lee references/routes/<flujo-de-trabajo>.md — un archivo pequeño por ruta: el contrato canónico de entrada/salida/disparador (disponible antes de que estén presentes las habilidades de flujo de trabajo instaladas de forma diferida) más el punto de entrada de la entrevista de esa ruta. Si el candidato no cumple con su contrato, continúa enrutando en lugar de forzar la coincidencia. Lee solo el archivo de la ruta coincidente.
Resolver ambigüedades comunes
- Una tarjeta de título animada corta, un sting de logotipo, un golpe de estadística, un golpe de gráfico, un golpe de mapa o un tercio inferior independiente es
/motion-graphicscuando no tiene narración y el movimiento es el mensaje. Una tarjeta de título estática, una secuencia narrada, un montaje más largo o un bucle personalizado es/general-video. - Un gráfico en movimiento explícitamente corto puede usar una URL, tweet, artículo o captura de pantalla como material de origen. Una solicitud genérica de "haz un video de este sitio" es
/product-launch-video. - El material existente con subtítulos se enruta a
/embedded-captions; el material con tarjetas de información diseñadas se enruta a/talking-head-recut. Reajustar el tiempo, reordenar, recolorear, reencuadrar o mezclar material es una edición personalizada y cae en/general-video. - Un archivo de música selecciona
/music-to-videosolo cuando su cuadrícula de ritmo impulsa la pieza. La música usada como fondo no anula la ruta determinada por el tema. - "Quiero un storyboard" cambia el proceso de revisión, no el flujo de trabajo. Sin otra señal de enrutamiento, usa
/general-video. Unstoryboard.htmlesbozado confirmado puede ser en sí mismo el entregable solicitado; el bucle de revisión define ese punto de parada. - Los flujos de trabajo narrativos especializados soportan hasta unos 3 minutos y son más efectivos entre 30 y 90 segundos. Enruta una pieza claramente más larga a
/general-video. La duración nunca anula un puerto explícito, deck, subtítulo, superposición o entregable impulsado por música.
3. Enrutar una vez, luego salir
Para la creación desde cero, la capa de intención (references/intent-interview.md) ejecuta la conversación completa — memoria, triaje, ronda de propuestas, imprescindibles, forma de ejecución, traspaso — y termina escribiendo BRIEF.md. El brief es el único artefacto de enrutamiento que lee el flujo de trabajo; nada más tarde reabre este skill o la entrevista. Responde cada pregunta posterior de "¿qué requirió la ruta?" desde BRIEF.md.
4. Instalar y entrar en el flujo de trabajo
Antes de leer el flujo de trabajo seleccionado, instálalo o actualízalo junto con las habilidades de dominio central:
npx hyperframes skills update <nombre-del-flujo-de-trabajo>
Usa el nombre simple sin /. Si el comando falla, muestra el error; no reconstruyas el flujo de trabajo de memoria. Todo lo demás sobre la instalación — la división entre habilidades centrales y diferidas, lo que init actualiza, diagnóstico, exclusión de CI y el fallback sin CLI — está en references/skill-lifecycle.md.
5. Cargar habilidades de dominio bajo demanda
| Necesidad | Habilidad |
|---|---|
| Estructura de composición, atributos de sincronización, pistas, variables, determinismo | /hyperframes-core |
| Reglas de movimiento, planos de escena, transiciones, adaptadores de tiempo de ejecución | /hyperframes-animation |
GSAP seguro de búsqueda, CSS, Anime.js, WAAPI, FLIP, trazados, máscaras, SVG, fotogramas clave 3D o diagnósticos de hyperframes keyframes | /hyperframes-keyframes |
| Especificaciones de diseño, concepto, paleta, tipografía, narración, planificación de ritmo | /hyperframes-creative |
| Imágenes, iconos, logotipos, audio, subtítulos, gradaciones, LUTs, medios reutilizables | /media-use |
| Tallado de voz en off, cadenas de efectos de audio, envolventes de automatización, o una cadena/atenuador en varias pistas (bus de submezcla) | /hyperframes-audio |
| Inicialización, lint, verificación, instantáneas, comparación, renderizado por lotes, Studio, renderizado, publicación o diagnósticos | /hyperframes-cli |
| Bloques y componentes del registro | /hyperframes-registry |
| Un aspecto, efecto, tratamiento o transición con nombre — líneas de barrido CRT, fallo, grano de película, barrido de brillo, ráfaga de confeti — ANTES de construirlo manualmente | /hyperframes-registry |
| Activos de Figma, tokens, componentes o fotogramas de storyboard como movimiento reconstruido | /figma |
Las frases de edición del creador son solicitudes entre dominios. Carga cada habilidad nombrada en la fila coincidente:
| Solicitud del creador | Dominios requeridos |
|---|---|
| Mover un clip, recortar, dividir, unir, reorganizar pistas | /hyperframes-core /hyperframes-cli |
| Cambiar la duración, velocidad, fundido, posición o rotación de un clip | /hyperframes-core /hyperframes-animation |
| Ajustar el color, contraste, saturación o desenfoque de un clip | /hyperframes-core /hyperframes-keyframes /hyperframes-creative |
| Reemplazar un clip por otro, intercambiar medios, actualizar desde Figma | /hyperframes-core /hyperframes-cli /figma |
| Cambiar la fuente, el tamaño del texto o el estilo de un clip de texto existente | /hyperframes-core /hyperframes-creative |
| Añadir una transición, un efecto o una superposición a un clip o a todo el proyecto | /hyperframes-core /hyperframes-animation /hyperframes-registry |
| Ajustar el volumen, añadir un efecto de audio o cambiar la voz en off de un clip | /hyperframes-core /hyperframes-audio |
| Exportar un fotograma, un clip o todo el proyecto en un formato diferente | /hyperframes-cli |
6. Manejar cuando HyperFrames no es el marco de salida
Si el usuario solicita explícitamente un marco de salida que no sea HyperFrames (por ejemplo, "renderiza esto en Remotion", "usa After Effects", "necesito un archivo de Premiere") o pide solo grabar una sesión del navegador, entonces:
- Lee primero
references/skill-lifecycle.md§1 para entender los límites dinámicos de instalación que pueden aplicar. - No ejecutes ningún flujo de trabajo de HyperFrames ni la capa de intención.
- Avisa que HyperFrames es el marco predeterminado y que la salida solicitada está fuera de su ámbito.
- Ofrece grabar una sesión del navegador (si eso es lo que se pide) o delegar a otra habilidad capaz de apuntar al marco solicitado.
- Pregunta confirmación antes de cambiar de marco o grabar, a menos que la solicitud sea inequívoca.
7. Referencias
references/plugin-installation.md— reglas de instalación de pluginsreferences/intent-interview.md— entrevista de intención completa para creación desde ceroreferences/routes/— un archivo por ruta con contratos de entrada/salidareferences/skill-lifecycle.md— ciclo de vida de instalación de habilidades, diagnóstico y CI/hyperframes-core— contrato de autoría de composición/hyperframes-cli— comandos de la interfaz de línea de comandos