Primero, mantén este skill actualizado — confirma con el usuario antes de ejecutar:
npx hyperframes skills update slideshow. Es un no-op rápido cuando todo está al día; de lo contrario, actualiza este skill junto con los skills del dominio base de los que depende antes de usarlos.
fuente figma: Si el contenido o guion gráfico del deck proviene de una URL de figma.com, ejecuta
/figmaprimero — exportación de recursos, tokens de marca y reconstrucción del guion gráfico si la fuente es una tira de fotogramas de escena — luego construye a partir de su salida. No uses directamente las herramientas MCP de Figma sin procesar: eso omite la sanitización de SVG, la procedencia de.media/manifest.jsonly el enlacevar()de tokens de marca, por lo que un cambio posterior de marca no se puede propagar sin una reimportación completa.
Contrato de autoría de presentaciones de diapositivas
Una presentación de diapositivas de HyperFrames es una composición normal de HyperFrames — escenas, clips, líneas de tiempo GSAP — con un ingrediente adicional: un "JSON island" que declara qué escenas son diapositivas y cómo se conectan. El SlideshowController del reproductor lee el "island" y convierte la línea de tiempo GSAP continua en un deck discreto y navegable.
Lee /hyperframes-core primero para el contrato base de composición (clips, pistas, atributos data-*, reglas de determinismo). Este skill cubre solo lo nuevo: el esquema del "island", reglas de escritura de diapositivas, fragmentos, ramificaciones, validación y el componente envolvente.
Salida — un deck navegable, no un MP4 lineal
La salida de una presentación de diapositivas es el deck en ejecución: sírvelo con hyperframes present <directorio-del-proyecto> (o el modo presentación de Studio) — el SlideshowController del reproductor lee el "island" y gestiona la navegación, fragmentos, ramificaciones y el modo presentador. Consulta Presentación y entrega más abajo.
No uses hyperframes render para convertir una presentación de diapositivas en un solo MP4. Un deck se autoría como varias composiciones de escena de alto nivel (un data-composition-id por diapositiva) sin una composición raíz principal que las envuelva, por lo que render resuelve solo la primera composición y emite un MP4 silenciosamente truncado (por ejemplo, 6 segundos de un deck de 40 segundos). Una exportación lineal principal (solo diapositivas principales, excluyendo secuencias de rama) está aplazada — hasta que se implemente, las salidas compatibles son el deck present en vivo y las imágenes fijas snapshot por diapositiva. Si un usuario necesita un MP4 lineal hoy, muestra esta limitación en lugar de apuntar render al deck.
Confirmación de intención
Si el usuario solicita explícitamente una presentación de diapositivas, slide show o presentación de diapositivas de HyperFrames, procede con este skill. Cuando la solicitud llegó a través de /hyperframes, el triaje de la capa de intención es el dueño de esta confirmación — si se ha enrutado aquí, ya está confirmado, así que no vuelvas a preguntar; las preguntas de forma de ejecución de la capa no aplican (el entregable es un deck, no un video renderizado). Un BRIEF.md, cuando está presente, lleva la intención confirmada — léelo.
Si el skill se activó a partir de una solicitud adyacente como "presentación", "pitch deck", "deck", "deck interactivo" o "convertir esta página", haz una pausa antes de autoría y enmarca la elección antes de pedir confirmación. Explica brevemente que una presentación de diapositivas de HyperFrames significa un deck ejecutable con diapositivas discretas, navegación incorporada y modo presentador, notas del orador editables, manejo de medios compartidos y validación antes de la entrega. Para conversiones de páginas fuente, también menciona que el objetivo es preservar el diseño visual original de la página, las interacciones, el movimiento y el comportamiento de los medios mientras se traduce el movimiento de la página en transiciones entre diapositivas.
Luego haz una breve pregunta de confirmación:
¿Quieres esto como una presentación de diapositivas de HyperFrames?
Usa una interfaz de opción sí/no cuando el entorno la proporcione; de lo contrario, haz la pregunta en texto plano.
No implementes la presentación de diapositivas hasta que el usuario diga que sí. Si dice que no, deja de usar este skill — lee /hyperframes y deja que la capa de intención re-enrute. Esta confirmación es una decisión de enrutamiento, no una compuerta de preferencia — según ../hyperframes/references/brief-contract.md § 1, sobrevive al modo autónomo ("sorpréndeme" no la omite): construir el tipo de entregable incorrecto es un fallo de calidad, no una decisión creativa.
Las dos partes
1. Escenas — declaradas de manera normal
Cada diapositiva está respaldada por una escena. Declara las escenas con data-composition-id, data-start, data-duration y data-label:
<div
data-composition-id="problem"
data-start="0"
data-duration="8"
data-label="The problem"
data-width="1920"
data-height="1080"
>
<!-- los clips van aquí -->
</div>
Las diapositivas de rama (accesibles solo a través de un hotspot, excluidas de la línea principal) se declaran exactamente de la misma manera — solo aparecen en una entrada slideSequences en el "island", no en el array slides principal.
2. El "JSON island" — un bloque de script por composición
Agrega exactamente un bloque <script type="application/hyperframes-slideshow+json"> al HTML de la composición. Contiene todos los metadatos de la presentación de diapositivas:
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
El "island" es la única fuente de verdad para el orden de las diapositivas, notas, puntos de retención de fragmentos, hotspots y secuencias de rama. Colócalo cerca del inicio de <body>, antes de los divs de escena, para que sea fácil de encontrar.
No escondas el manifiesto de la presentación de diapositivas detrás de un bloque <script type="application/json"> alternativo más código en tiempo de ejecución que crea el "island". El comando present lee el HTML de la composición estáticamente y espera que el "island" real application/hyperframes-slideshow+json ya esté presente.
Esquema
SlideshowManifest (el objeto "island" de nivel superior)
{
"slides": [
/* SlideRef[] — la línea principal, en orden */
],
"slideSequences": [
/* SlideSequence[] — secuencias de rama fuera de línea */
]
}
SlideRef
{
"sceneId": "problem",
"notes": "Empieza con el dolor, no con la empresa.",
"fragments": [3.5, 5.2, 7.0],
"hotspots": [
/* SlideHotspot[] */
],
"ttsScript": null,
"ttsAudioUrl": null,
"ttsDurationMs": null
}
| Campo | Obligatorio | Notas |
|---|---|---|
sceneId | sí | Debe coincidir exactamente con el data-composition-id de una escena (o proporcionar explícitamente startTime/endTime). La regla de lint resuelve escenas por data-composition-id. |
notes | no | Texto solo para el presentador. Nunca se muestra a la audiencia. |
fragments | no | Array de tiempos (segundos) dentro del rango [start, end] de la diapositiva — consulta Fragmentos más abajo. |
hotspots | no | Superposiciones interactivas que activan una rama — consulta Ramificaciones más abajo. |
startTime | no | Opcional. Sobrescribe los límites de tiempo de la escena coincidente; por defecto, inicio/fin de la escena. |
endTime | no | Opcional. Sobrescribe los límites de tiempo de la escena coincidente; por defecto, inicio/fin de la escena. |
ttsScript, ttsAudioUrl, ttsDurationMs | no | Reservado. Los campos del esquema existen, pero la reproducción de TTS aún no está conectada. Omitir a menos que estés prellenando para una compilación futura. |
SlideHotspot
{
"id": "h1",
"label": "¿Cómo calculamos esto?",
"target": "market-deep-dive",
"region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
| Campo | Obligatorio | Notas |
|---|---|---|
id | sí | Único dentro de la diapositiva. |
label | sí | Texto de información sobre herramientas / botón mostrado a la audiencia. |
target | sí | Debe coincidir con un SlideSequence.id en slideSequences. |
region | no | Cuadro delimitador en porcentaje de la diapositiva: {x, y, w, h} en 0–100. Omitir para que el hotspot se renderice como un botón etiquetado de diapositiva completa. |
SlideSequence
{
"id": "market-deep-dive",
"label": "Metodología de dimensionamiento de mercado",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
slides dentro de una secuencia usa la misma forma SlideRef que la línea principal. Se permiten fragmentos y hotspots anidados.
Reglas de escritura de diapositivas
Estas son restricciones estrictas, no sugerencias. Una diapositiva que las viole será reemplazada directamente cuando un revisor la vea.
- El titular es una afirmación de oración completa, no una etiqueta. Escribe "Las PYMES dedican 14 horas/semana a la programación manual" no "Problema de programación". La oración debe tener sentido por sí sola si se ignora el contenido visual.
- Una idea + un visual por diapositiva. Si te sientes tentado a agregar un segundo grupo de viñetas o un segundo gráfico, divide la diapositiva.
- Empieza con la conclusión. El punto más fuerte va primero — en la diapositiva y en el orden del deck. Los inversores leen de izquierda a derecha, de arriba a abajo, y se detienen.
- Solo dimensionamiento de mercado ascendente. Nunca escribas "TAM de $50B" sin mostrar los cálculos. Construye desde la economía unitaria hacia arriba: cuentas × ACV, o transacciones × tasa de captación.
- Tamaño de fuente mínimo equivalente a 30pt. A 1920×1080, un titular es de 72–96px; el cuerpo del texto es de 48px. Nunca bajes de 40px para cualquier texto que la audiencia deba leer.
- Busca en el catálogo en vivo antes de construir manualmente cualquier visual con nombre. Para cada aspecto visual, efecto, gráfico, tratamiento o transición que necesite una diapositiva — "líneas de barrido CRT", "glitch", "carrera de gráficos de barras", "barrido de brillo", "ventana de terminal" — ejecuta
npx hyperframes catalog --query "<el visual, en inglés simple>" --jsony lee los mejores resultados antes de autorizar los clips de la diapositiva. La búsqueda no necesita nada instalado: ningún proyecto,addprevio, ni cuenta. Clasifica todo el registro alojado (~400 bloques y componentes) desde cualquier directorio.npx hyperframes add <nombre>coloca la fuente del bloque en el deck, donde lo personalizas en su lugar. Esto aplica con fuerza adicional al portar una página fuente: un bloque real supera a la aproximación simplificada que las reglas de portabilidad siguientes prohíben.
Portabilidad de páginas fuente
Al convertir una página existente en una presentación de diapositivas, la fidelidad a la fuente es parte del contrato. No reemplaces widgets específicos de la fuente con aproximaciones simplificadas a menos que el usuario solicite explícitamente un rediseño.
- Preserva el diseño visual original de la página, el lenguaje de movimiento, el comportamiento interactivo, el comportamiento de los medios y las capacidades de presentación lo más fielmente posible en la práctica. Cuando el sistema de presentación de diapositivas admita el modo presentador, incluye notas del orador usando el comportamiento compartido de notas editables en lugar de una implementación específica del deck.
- Porta los elementos visuales mecánicos del DOM/CSS/JS de la fuente con la mayor precisión posible: reproductores personalizados, visualizadores de lienzo, líneas de tiempo, cabezales de reproducción, stems, círculos en expansión, estados de hover y otros detalles interactivos deben sobrevivir a la conversión.
- Trata los elementos
<video>/<audio>nativos como la fuente de verdad para cualquier cromo de medios personalizado, visualizador de lienzo, forma de onda, cuadrícula de ritmo o cabezal de reproducción. Conecta los eventos de medios de la fuente (play,pause,timeupdate,seeking,seeked,ended,ratechange,volumechange) y deriva el estado visual demedia.currentTime; no ejecutes un temporizador separado que pueda desviarse de la reproducción real. - Cada
<video>o<audio>copiado consrcdebe tener atributos de tiempo de HyperFrames antes del lint:data-startydata-duration, másdata-has-audio="true"cuando se deba preservar el audio nativo audible. Usa el rango de tiempo de la escena para medios específicos de la diapositiva; para videos de evidencia controlados por el usuario que puedan reproducirse desde múltiples diapositivas enfocadas, usa un rango de todo el deck. No dejespreload="none"en los medios; usametadataoauto. - Resuelve los tokens de fuente de la fuente antes de la validación. Si preservas fuentes personalizadas de la fuente, agrega reglas
@font-facepara los archivos de fuente locales/capturados. Si usas alternativas del sistema, reemplaza declaraciones tokenizadas comofont-family: var(--f-body)con stacks concretos seguros para renderizado comosystem-ui, sans-serifoui-monospace, monospace; no dejesvar(...)como valor de la familia de fuente. - Audita la fuente en busca de movimientos atípicos de página, especialmente comportamiento impulsado por scroll, wheel, touch, estado hash, resize o un bucle de requestAnimationFrame. Trata los viewports fijos con capas "world" traducidas/escaladas, parallax, paneles fijos, desplazadores horizontales, líneas de tiempo depuradas por scroll, ajuste de secciones y cámaras de zoom a elemento como comportamiento de la fuente. El scroll es a menudo el desencadenante de transición de la fuente, así que preserva la transición extrayendo sus paradas de progreso, easing y estados de cámara/enfoque, luego reubica ese movimiento en la navegación de la presentación de diapositivas a través de posiciones de línea de tiempo, fragmentos o un gancho reutilizable de reproductor/arnés. Los wrappers independientes que saltan a puntos de retención de diapositivas aún necesitan un gancho de transición de cámara de navegación explícito; calcular transformaciones de cámara por diapositiva no es suficiente. No simules una transición literal de desplazamiento hacia abajo dentro de la diapositiva; el espectador debe sentir un viaje/zoom de cámara de un punto focal a otro, no ver una página web siendo desplazada. Mantén cada movimiento de cámara entre diapositivas continuo: evita paradas de ruta intermedias que inviertan la dirección x/y o deshagan el zoom.
… (contenido truncado para traducción)