checklist-overlay
Una grabación de pantalla a la izquierda, una lista de verificación a la derecha. Cada elemento se marca en el instante en que su paso ocurre en pantalla. Después del último marcado, el vídeo se detiene brevemente en una lista completamente verificada.
Entradas
| Entrada | Notas |
|---|---|
| Grabación | Un archivo de vídeo local, idealmente 16:9. El silencio está bien. |
| Pasos | De 3 a 7 elementos: { "label": "...", "at": <segundos de la grabación> }. Las etiquetas son frases imperativas cortas (de 2 a 4 palabras aproximadamente). |
| Título | Una línea. Menciona el resultado ("Consigue un skill en tu agente en 5 pasos"). |
| Subtítulo | Una línea opcional. |
| Paleta | Opcional: anulaciones hex: bg, surface, panel, ink, muted, accent, border, accentInk. El valor predeterminado es oscuro con un acento naranja. Mantén accentInk lo suficientemente oscuro para leer sobre accent. |
Si la persona no proporciona marcas de tiempo, examina la grabación (extrae fotogramas cada 1 o 2 segundos con ffmpeg, obsérvalos) y elige el primer fotograma donde cada paso esté visiblemente completado o en curso. No adivines.
Flujo de trabajo
- Carga
/hyperframes,/hyperframes-core,/hyperframes-clipara el contrato del proyecto. - Escribe
spec.json:{ "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" }, "steps": [ { "label": "Abrir la aplicación", "at": 1.5 }, { "label": "Buscar", "at": 7.9 } ] } - Genera la composición en el directorio del proyecto:
node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2]Esto copia la grabación, extrae el último fotograma (para que la imagen se mantenga después de que termine la grabación) y escribeindex.htmlcon el tamaño de la grabación. La duración total = duración de la grabación + pausa (por defecto 2.2 s). npx --yes hyperframes checkdebe pasar sin errores ni advertencias.- Valida (abajo), luego renderiza:
npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4.
Reglas de sincronización
- El marcado cae exactamente en el paso, nunca antes. El relleno y el dibujo de la marca comienzan en
t = at; el dibujo termina aproximadamente 0.3 s después. Nada en el elemento debe parecer marcado antes deat. - Las marcas de tiempo son tiempo de grabación y la grabación comienza en el tiempo de composición 0, por lo que
atse usa sin cambios. Si recortas la grabación, desplaza cadaaten la misma cantidad. - Puede aparecer un contorno de "siguiente" en el próximo elemento poco después del marcado anterior. Es solo un contorno, nunca un relleno o una marca.
- Mantén los marcados con al menos 1.5 s de diferencia para que cada uno se lea. Si dos pasos están más cerca, combínalos.
- El último marcado debe situarse al menos 1.5 s antes de que termine la grabación, o aumenta
--holdpara que la lista terminada sea visible durante 2 s o más. - El contador (
n / N), la barra de progreso y el anillo del fotograma se sincronizan con los mismos valoresat, por lo que permanecen sincronizados.
Diseño (grabaciones 16:9)
Lienzo de 1920x1080, márgenes de 56 px. Título y subtítulo en la parte superior; el marco de la grabación es el elemento principal de aproximadamente 1250 px de ancho (aproximadamente el 65 por ciento del ancho), el panel de la lista de verificación es una columna de 520 px a su derecha, con la misma altura que el marco, los elementos comparten la altura por igual. Esto mantiene legible el texto de la interfaz de usuario en la grabación. No reduzcas el marco por debajo de aproximadamente 1100 px de ancho; para una grabación más alta, el generador escala el marco según la relación de aspecto. Grabaciones que no sean 16:9: verifica que el marco aún quepa debajo del encabezado, o recorta la grabación primero.
Las etiquetas se ajustan a dos líneas a 32 px; mantenlas por debajo de aproximadamente 26 caracteres.
Validación
Haz esto en el final.mp4 renderizado, no solo en capturas:
- Para cada paso, extrae un fotograma 0.08 s antes de
aty uno 0.45 s después:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png. - Obsérvalos. Antes: elemento sin marcar, contador en i-1. Después: elemento relleno con una marca, contador en i, barra de progreso avanzada.
- Extrae un fotograma en la pausa final (aproximadamente 0.2 s antes del final): todos los elementos marcados, contador
N / N, barra completa. - Verifica que el texto de la grabación sea legible en el fotograma y que ninguna etiqueta esté recortada. Corrige
spec.jsono la paleta y regenera si no es así. ffprobeel archivo: 1920x1080, h264, duración = grabación + pausa.
Entrega
Informa la ruta a final.mp4, su duración y las marcas de tiempo de los pasos utilizados. Conserva el directorio del proyecto (index.html, assets/, spec.json) para que el vídeo pueda regenerarse con diferentes etiquetas o paleta. Abre npx hyperframes preview primero si la persona quiere editar en Studio.