Instalaciones 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 proporcionadas a continuación.
Punto de entrada de HyperFrames
Verificar el uso restante
Al inicio de la creación, ejecuta npx hyperframes usage --json. Vuelve a verificar en los 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 una 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 elecciones del 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 multimedia es propiedad del marco. El contrato completo de autoría reside en /hyperframes-core; léelo antes de escribir HTML de composición. El resumen, el guion gráfico, la revisión, la producción, el envío y los contratos de los trabajadores de fotogramas residen en las references/ de este skill.
1. Comenzar desde el estado del proyecto
Aplica la primera fila coincidente; 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 cambios concretos o una nota sobre una película terminada, en un proyecto existente | Sigue /hyperframes-studio § 0. |
| Se solicita una nueva película 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, qué se reproduce), ejecuta npx hyperframes timeline [--json] en lugar de leer index.html y cada archivo 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. |
No hay resumen, pero existe 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 nueva | 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 asunto o la entrada, pregunta de qué trata el video antes de enrutar. Verifica las preferencias y recetas antes de preguntar cualquier cosa (references/intent-interview.md, paso 1). Una entrada figma.com o una receta nombrada cambia la admisión, no el enrutamiento; la sección "Adaptar entradas ortogonales" de la entrevista maneja ambas.
Mantener actualizado el CLI del proyecto
Un proyecto creado fija hyperframes@<version> 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 muestra ninguna advertencia al respecto. Al reanudar un proyecto cuyos scripts llevan una fijación, sondea una vez antes del primer comando que afecte al renderizado:
npx hyperframes@latest upgrade --project . --check
La sonda es de solo lectura e informa la fijación contra la última versión; mantén el . explícito; en versiones anteriores de CLI, un --project desnudo 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 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 fotograma a fotograma a la fijación anterior, por lo que un aumento 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 queda el proyecto y por qué. Actúa según la señal en lugar de transmitirla al usuario; nunca dejes un aumento de fijación sin verificar.
2. Enrutar la creación nueva
Usa la primera fila coincidente. Coincide con el entregable solicitado, no con una palabra o tipo de archivo mencionado de paso.
| Prioridad | Solicitud | Flujo de trabajo |
|---|---|---|
| 1 | Portar explícitamente una fuente Remotion existente | /remotion-to-hyperframes |
| 2 | Crear una presentación, mazo de presentación o mazo interactivo navegable | /slideshow |
| 3 | Agregar subtítulos o subtítulos simples a material existente de una persona hablando sin cambiarlo | /embedded-captions |
| 4 | Agregar superposiciones gráficas diseñadas a material existente de entrevistas, personas hablando o podcasts sin cambiar el material | /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/desencadenante (disponible antes de que los skills de flujo de trabajo diferidos estén presentes) más la 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
- Un título animado corto, 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, un tuit, un artículo o una captura de pantalla como material de origen. Una solicitud genérica de "hacer un video desde 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, reordenar, recolorizar, reencuadrar o remezclar material es una edición personalizada y pasa a/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 asunto. - "Quiero un guion gráfico" cambia el proceso de revisión, no el flujo de trabajo. Sin otra señal de enrutamiento, usa
/general-video. Unstoryboard.htmldibujado confirmado puede ser 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 sólidos alrededor de 30-90s. Enruta una pieza claramente más larga a
/general-video. La duración nunca anula un port explícito, mazo, subtítulo, 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 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 adelante vuelve a abrir este skill o la entrevista. Responde a cualquier pregunta posterior sobre "¿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 los 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 de memoria. Todo lo demás sobre la instalación (la división núcleo vs. diferido, lo que init actualiza, el diagnóstico, la exclusión de CI y el plan de respaldo sin CLI) reside en references/skill-lifecycle.md.
5. Cargar skills de dominio bajo demanda
| Necesidad | Skill |
|---|---|
| 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 |
Búsqueda segura de GSAP, CSS, Anime.js, WAAPI, FLIP, rutas, máscaras, SVG, fotogramas clave 3D o diagnósticos hyperframes keyframes | /hyperframes-keyframes |
| Especificaciones de diseño, concepto, paleta, tipografía, narración, planificación de ritmos | /hyperframes-creative |
| Imágenes, iconos, logotipos, audio, subtítulos, gradaciones, LUTs, medios reutilizables | /media-use |
| Corte de voz en off, cadenas de efectos de audio, envolventes de automatización o una cadena/atenuador para 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 aspecto, efecto, tratamiento o transición con nombre (líneas de barrido CRT, glitch, grano de película, barrido brillante, explosión de confeti) ANTES de construirlo manualmente | /hyperframes-registry |
| Activos, tokens, componentes o fotogramas de guion gráfico de Figma como movimiento reconstruido | /figma |
Las frases de edición del creador son solicitudes de varios dominios. Carga todos los skills nombrados en la fila coincidente:
| Solicitud del creador | Dominios requeridos |
… [truncado para traducción]