Communitygithub.com

SingleGrain-Team/video-skills

Construye un motion graphic donde una grabación de pantalla se reproduce en un marco grande junto a una lista de verificación, y cada elemento se marca exactamente en el momento en que ocurre ese paso en la grabación, terminando con todos los elementos marcados y una breve pausa.

¿Qué es video-skills?

Este skill te permite crear vídeos estilo 'lista de verificación animada' para demostraciones de productos, tutoriales o guías de instalación. Combina una grabación de pantalla (product walkthrough, onboarding, instalación) con una lista de pasos y marcas de tiempo, y genera un motion graphic donde cada elemento de la lista se marca exactamente en el instante en que ocurre en el vídeo. El resultado es un archivo MP4 en 1920x1080 H.264 y un proyecto editable de HyperFrames. Es compatible con cualquier agente que soporte skills (Claude Code, Cursor, Codex, etc.) y su flujo de trabajo incluye desde la generación del proyecto, validación con ffmpeg y ffprobe, hasta la renderización final. La entrada requiere una grabación de pantalla, una lista de 3 a 7 pasos con marcas de tiempo, un título y opcionalmente una paleta de colores. Si no se proporcionan marcas de tiempo, el skill puede extraer fotogramas cada 1-2 segundos para determinar el momento exacto de cada paso.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/checklist-overlay

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

EntradaNotas
GrabaciónUn archivo de vídeo local, idealmente 16:9. El silencio está bien.
PasosDe 3 a 7 elementos: { "label": "...", "at": <segundos de la grabación> }. Las etiquetas son frases imperativas cortas (de 2 a 4 palabras aproximadamente).
TítuloUna línea. Menciona el resultado ("Consigue un skill en tu agente en 5 pasos").
SubtítuloUna línea opcional.
PaletaOpcional: 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

  1. Carga /hyperframes, /hyperframes-core, /hyperframes-cli para el contrato del proyecto.
  2. Escribe spec.json:
    { "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" },
      "steps": [ { "label": "Abrir la aplicación", "at": 1.5 }, { "label": "Buscar", "at": 7.9 } ] }
    
  3. 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 escribe index.html con el tamaño de la grabación. La duración total = duración de la grabación + pausa (por defecto 2.2 s).
  4. npx --yes hyperframes check debe pasar sin errores ni advertencias.
  5. 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 de at.
  • Las marcas de tiempo son tiempo de grabación y la grabación comienza en el tiempo de composición 0, por lo que at se usa sin cambios. Si recortas la grabación, desplaza cada at en 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 --hold para 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 valores at, 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:

  1. Para cada paso, extrae un fotograma 0.08 s antes de at y uno 0.45 s después: ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png.
  2. Obsérvalos. Antes: elemento sin marcar, contador en i-1. Después: elemento relleno con una marca, contador en i, barra de progreso avanzada.
  3. Extrae un fotograma en la pausa final (aproximadamente 0.2 s antes del final): todos los elementos marcados, contador N / N, barra completa.
  4. Verifica que el texto de la grabación sea legible en el fotograma y que ninguna etiqueta esté recortada. Corrige spec.json o la paleta y regenera si no es así.
  5. ffprobe el 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.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an editable HyperFrames project.

SingleGrain-Team/video-skills

Builds a 6-8 second logo sting in which the brand mark rides inside a refracting liquid bead (distorted past legibility), the bead swells, holds still for a beat, then ruptures into droplets and leaves the logo lockup (mark plus wordmark) crisp and upright on screen. Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project, with no 3D model, stock footage or generation model. Use it for brand intros and outros, product-launch openers, channel stings and any "reveal our logo" moment, from an SVG or PNG logo (including raster-only logos), a wordmark string and a palette.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

Skills relacionados