Communitygithub.com

BintzGavin/helios-skills

Flujo de trabajo guiado de principio a fin para crear un video explicativo o tutorial. Extrae la identidad de marca del repositorio, genera una banda sonora personalizada y produce una composición narrativa con motion.dev renderizada mediante la CLI de Helios. Úsalo para crear videos de 'cómo funciona', demostraciones de funciones o contenido educativo.

¿Qué es helios-skills?

Esta skill te guía paso a paso en la creación de un video explicativo profesional, empezando por la recopilación de contexto del usuario y la extracción de la identidad visual de la marca (desde el repositorio o un sitio web). Puede generar música de fondo instrumental a través de ElevenLabs y analizarla con ffmpeg para sincronizar las transiciones y las animaciones con el ritmo de la pista. La skill produce una especificación creativa detallada con un arco narrativo (Gancho → Problema → Solución → Cómo funciona → CTA) y la implementa como una composición HTML+CSS+motion.dev que se renderiza como un archivo MP4 con la CLI de Helios. Está diseñada para desarrolladores que usan Claude Code, Cursor, Codex o agentes de IA similares, y requiere tener instalados Node.js, npm, y ffmpeg, además de una clave API de ElevenLabs si se desea música generada.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/explainer-video

Preguntar en tu IA favorita

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

Documentación

Puede que estés operando dentro del repositorio de la marca, o trabajando desde un contexto externo.

No adivines la identidad de la marca. Analiza el código fuente o investiga la URL proporcionada.


PIPELINE DE EJECUCIÓN

PASO 1 — Recopilar contexto

⛔ DETENTE. Haz al usuario estas dos preguntas:

  1. "¿Estamos dentro del repositorio de tu marca, o prefieres proporcionar una URL (por ejemplo, tu sitio de marketing) para que pueda investigar tu marca en línea?"

  2. "¿Te gustaría que generara música de fondo? Si es así, necesitarás tener la variable de entorno ELEVEN_LABS_API_KEY. Puedes obtener una en https://elevenlabs.io → Perfil → Claves API."

Espera a que el usuario responda ambas preguntas.

No intentes leer archivos .env ni verificar las claves por tu cuenta. Confía en las respuestas del usuario.

Si el usuario proporciona una URL, úsala para la investigación de marca en el PASO 3 en lugar de analizar el código fuente. Si el usuario rechaza la música, omite el PASO 4 y el PASO 5.


PASO 2 — Asegurar las dependencias de Helios en tiempo de ejecución

Instala los paquetes necesarios:

npm install @helios-project/core @helios-project/renderer @helios-project/cli

Renderizarás usando el modo DOM.


PASO 3 — Extraer la inteligencia de marca del repositorio

Si el usuario proporcionó una URL en lugar de un repositorio, obtén esa URL y extrae las mismas señales de marca del sitio en vivo. Omite los elementos específicos del código base (configuración de Tailwind, tokens de diseño, etc.) y concéntrate en los elementos visuales de la marca.

Analiza:

• Configuración de Tailwind o variables CSS • Hojas de estilo globales • Tokens de diseño • Archivos de logotipo • Favicon • Estructura de la documentación • Descripciones de funciones • Flujos de incorporación • Texto de ayuda y microcopia • Arquitectura de la información • Componentes de la interfaz de usuario • Uso existente de motion

Construye un perfil de marca interno:

• Propuesta de valor principal • Público objetivo • Tono de voz (instructivo, comprensivo, autoritario) • Densidad visual • Paleta principal • Paleta de acento • Carácter tipográfico • Patrones de jerarquía de la información • Estilo de explicación (prioridad visual vs. mucho texto)

Todas las decisiones creativas deben alinearse con esto.


PASO 4 — Generar música original (Omitir si no hay música)

Usa ElevenLabs con la clave ELEVEN_LABS_API_KEY existente.

Genera una pista instrumental que coincida con:

• Tono tranquilo y comprensivo • Progresión constante sin picos dramáticos • Presencia sutil de fondo (no debe competir con la narración) • Duración objetivo

Guarda el audio localmente.


PASO 5 — Analizar el audio con ffmpeg (Omitir si no hay música)

Extrae:

• BPM • Marcas de tiempo de los beats • Tiempos fuertes (downbeats) • Picos de energía

Crea un mapa de sincronización de beats.

Las transiciones entre secciones deben alinearse con los tiempos fuertes. Las revelaciones de texto en pantalla deben alinearse con los beats.


PASO 6 — Leer las reglas de diseño de motion

Antes de producir la especificación creativa, lee e interioriza:

skills/guided/motion-design-rules

Todas las reglas de esa skill son obligatorias para esta composición.


PASO 7 — Producir la especificación creativa

Eres un director creativo sénior y arquitecto de diseño instruccional que diseña para Helios usando motion.dev.

Ejemplo de entrada: "explica cómo funciona nuestro flujo de pago en 60 segundos"

Salida:

• Una especificación creativa estructurada • Envuelta en un único bloque de código • Sin explicación fuera de él

La especificación debe incluir:

• Duración • Relación de aspecto (16:9) • Resumen de la marca • Arco narrativo (Introducción → Problema → Solución → Cómo funciona → CTA) • Lenguaje de movimiento (medido, deliberado, progresivo) • Desglose de secciones sincronizadas con los beats • Marcas de tiempo exactas por sección • Guion de locución (conversacional, claro) • Texto en pantalla (encabezados de sección, etiquetas de funciones, números de paso) • Composición visual (diseños limpios, espacios en blanco generosos) • Comportamiento de animación explícito de motion.dev • Lógica de transición (fundidos suaves entre secciones, deslizamientos para el contenido) • Orden de capas • Dirección de audio • Requisitos de activos • Indicadores de paso o marcadores de progreso

Usa únicamente terminología compatible con motion.dev.

Requisitos de la estructura narrativa:

• Gancho inicial (primeros 5 segundos) • Identificación del problema • Introducción de la solución • Guía paso a paso • Resumen y CTA


PASO 8 — Implementar la composición DOM de Helios

Usando la especificación creativa:

Crea un archivo composition.html que:

• Use HTML + CSS + motion.dev • Implemente animaciones usando WAAPI / CSS / motion.dev • Alinee las transiciones de las secciones con los tiempos fuertes • Use encabezados de sección claros con numeración de pasos • Incluya el archivo de audio generado • Tenga la duración exacta • Priorice la legibilidad y la claridad visual

Expón el runtime de Helios:

import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

Requisitos:

• window.helios debe estar definido • Se debe llamar a helios.bindToDocumentTimeline() • autoSyncAnimations: true debe estar habilitado • Todas las animaciones CSS y WAAPI deben sincronizarse correctamente • Sin aleatoriedad • Tiempos deterministas • El texto debe permanecer en pantalla el tiempo suficiente para ser leído (mínimo 3 segundos por mensaje clave)


PASO 9 — Renderizar usando la CLI oficial de Helios (modo DOM)

Renderiza con:

npx @helios-project/cli render ./composition.html -o output.mp4

Requisitos:

• Relación de aspecto 16:9 • Duración correcta • Audio adjunto • CSS y WAAPI completamente sincronizados • Salida MP4 de alta calidad

El archivo de salida debe ser:

output.mp4


REGLAS DE EJECUCIÓN

Si la duración es ≤ 30 segundos: Comprimir a: Gancho → Concepto principal → CTA.

Si no se especifica duración: Valor predeterminado: 60 segundos.

Máximo 5 secciones para cualquier duración. Cada sección debe tener un encabezado claro en pantalla. El ritmo debe permitir la comprensión — nunca apresurar la información.

Nunca repitas la indicación original. Nunca expliques el razonamiento. La especificación creativa debe mostrarse dentro de un único bloque de código.

Individual skills in this repo

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

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

BintzGavin/helios-skills

End-to-end guided workflow for creating a promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

BintzGavin/helios-skills

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

BintzGavin/helios-skills

Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

Skills relacionados