Instalación de plugins: Antes de los comandos de configuración o actualización, sigue las reglas de ejecución de plugins cuando esta skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes mantienen 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 verificar 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 del flujo de trabajo con el usuario.
HyperFrames renderiza video desde HTML — una composición es un archivo HTML cuyo DOM declara tiempos con atributos data-*, cuyo tiempo de ejecución de animación es buscable y cuya reproducción multimedia pertenece al framework. El contrato de autoría completo está en /hyperframes-core; léelo antes de escribir el HTML de la composición. Los contratos de resumen, storyboard, revisión, producción, envío y cuadro de trabajo están en references/ de esta 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 la intención y el enrutamiento del flujo de trabajo; carga /hyperframes-cli y cualquier skill de dominio requerida. |
| Una pregunta, una pausa, una idea sin cambio concreto o una nota emocional 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 de 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, contenido reproducido), ejecuta npx hyperframes timeline [--json] en lugar de leer index.html y todos los archivos de subcomposición. |
BRIEF.md existe | Lee workflow y flow. Ejecuta ese flujo de trabajo; flow: companion siempre se ejecuta en /general-video. No hagas preguntas sobre el resumen. |
Sin resumen, pero hyperframes.json o STORYBOARD.md existe | 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 realices la entrevista de intención. |
| Creación nueva | Ejecuta la capa de intención — references/intent-interview.md — luego enruta una vez usando la tabla de § 2. |
Cuando edites un proyecto existente, encierra 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 figma.com o una receta nombrada cambia la recepción, no el enrutamiento; la sección "Adaptar entradas ortogonales" de la entrevista maneja ambas.
Mantener actualizado el CLI del proyecto
Un proyecto inicializado 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 tienen una fijación, prueba una vez antes del primer comando que afecte el renderizado:
npx hyperframes@latest upgrade --project . --check
La prueba 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 desnudo seguido de otra bandera consume esa bandera como su valor de directorio. Cuando informe que el proyecto está desactualizado — o cualquier salida del CLI ya lo muestre (el aviso de stderr This project pins hyperframes@… (latest …), 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 antigua — por lo que un aumento exitoso nunca es silencioso: nombra la versión antigua 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 queda el proyecto y por qué. Actúa sobre la señal en lugar de transmitirla al usuario; nunca dejes una fijación aumentada sin verificar.
2. Enrutar creación nueva
Usa la primera fila que coincida. Haz coincidir el entregable solicitado, no una palabra o tipo de archivo mencionado de pasada.
| Prioridad | Solicitud | Flujo de trabajo |
|---|---|---|
| 1 | Portar explícitamente una fuente Remotion existente | /remotion-to-hyperframes |
| 2 | Crear una presentación, pitch deck o deck interactivo navegable | /slideshow |
| 3 | Agregar subtítulos o subtítulos simples a metraje existente de persona hablando sin cambiarlo | /embedded-captions |
| 4 | Agregar superposiciones gráficas diseñadas a metraje existente de persona hablando, entrevista o podcast sin cambiar el metraje | /talking-head-recut |
| 5 | Construir un video sincronizado con el ritmo a partir de una pista de música, sin narración ni captura de sitio web | /music-to-video |
| 6 | Crear una unidad explícitamente corta, sin narración y 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 resumen 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/<workflow>.md — un archivo pequeño por ruta: el contrato canónico de entrada/salida/disparador (disponible antes de que las skills de flujo de trabajo instaladas de forma diferida estén presentes) más la entrada de 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 logo, un golpe de estadística, un golpe de gráfico, un golpe de mapa o un tercio inferior independiente es
/motion-graphicscuando no está narrado 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 "haz un video de este sitio" es
/product-launch-video. - El metraje existente con subtítulos se enruta a
/embedded-captions; el metraje con tarjetas de información diseñadas se enruta a/talking-head-recut. Reajustar, reordenar, recolorizar, reencuadrar o remezclar metraje 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 utilizada como fondo no anula la ruta coincidente con 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 admiten hasta aproximadamente 3 minutos y son más efectivos alrededor de 30–90s. Enruta una pieza claramente más larga a
/general-video. La duración nunca anula un port explícito, deck, subtítulos, superposición o entregable impulsado por música.
3. Enrutar una vez, luego salir
Para la creación nueva, la capa de intención (references/intent-interview.md) ejecuta toda la conversación — memoria, triaje, ronda de propuestas, requisitos indispensables, forma de ejecución, entrega — y termina escribiendo BRIEF.md. El resumen es el único artefacto de enrutamiento que lee el flujo de trabajo; nada más adelante reabre esta skill o la entrevista. Responde cada pregunta posterior de "¿qué requería 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 skills 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 desde la memoria. Todo lo demás sobre la instalación — la división entre skills centrales y diferidas, lo que init actualiza, el diagnóstico, la exclusión de CI y el fallback sin CLI — está en references/skill-lifecycle.md.
5. Cargar skills de dominio bajo demanda
| Necesidad | Skill |
|---|---|
| Estructura de composición, atributos de tiempo, 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, rutas, 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, grados, LUTs, medios reutilizables | /media-use |
| Tallado de voz en off, cadenas de efectos de audio, envolventes de automatización o una cadena/atenuador a través de varias pistas (bus de submezcla) | /hyperframes-audio |
| Inicio, 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 look, efecto, tratamiento o transición nombrados — líneas de barrido CRT, glitch, grano de película, barrido de brillo, explosión de confeti — ANTES de construirlo manualmente | /hyperframes-registry |
| Activos, tokens, componentes o marcos de storyboard de Figma como movimiento reconstruido | /figma |
Las frases de edición del creador son solicitudes entre dominios. Carga cada skill nombrada en la fila coincidente:
| Solicitud del creador | Dominios requeridos